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System generation is a process that generates an IBM 
System/360 Operating System adapted to both the machine 
configuration and the data processing requirements of 
an installation. The system generation process is 
performed under the control of an existing IBM System/ 
360 Operating System. This publication provides infor- 
mation on the machine and operating system requirements 
for system generation, the initialization of system 
volumes and data sets, the macro-instructions used in 
specifying system generation, the methods of including 
user-written programs in the operating system, restart 
procedures, and the sample programs used to test the 
new system. 

IBM provides a starter operating system that can be 
used for the first system generation. The procedures 
required to initialize the starter System are also 
described in this publication. 




PREFACE 



This publication provides system pro- 
grammers with information about the system 
generation process provided with IBM 
System/360 Operating System. The reader 
must be familiar with the various facili- 
ties and options offered within IBM System/ 
360 Operating System, and must have already 
decided upon the operating system configu- 
ration to be generated. 

This publication tells him how to gene- 
rate the operating system configuration he 
has selected. The following IBM System/360 
Operating System publications are required 
to understand and select the operating 
system to be generated: 

IBM System/360 Operating System; Intro- 
duction , Form C28-6534 

IBM Systein/360 Operating System: Con- 
cepts and Facilities , Form C28-6535 



IBM System/360 Operating System; System 
Programmer's Guide , Foinn C28-6550 



The following publications are required 
for a better understanding of the system 
generation process; 



IBM System/3 60 Operating System: Job 
Control Language , Form C28-6539 



IBM Svstem/360 



Operating 



System; 



Assembler Language , Form C28-6514 

Reference is made throughout this publi- 
cation to several utility programs. The 
reader must be familiar with the require- 
ments and facilities they provide. The 
utility programs are described in the 
publication; 



IBM 



System/360 Operating System; 



Storage Estimates , Form C28-6551 



IBM System/360 Operating System: 
ties . Form C28-6586 
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C28-6554-2 and obsoletes it. In addition to incorporating information 
released in Technical Newsletters N28-2230 and N28-2252, significant 
changes have been made. All sections, except "Specifying the System," 
are either new or have been completely rewritten and should be reviewed 
in their entirety. Changes to the section "Specifying the System" are 
indicated by a vertical line to the left of the change; revised 
illustrations are denoted by the symbol • to the left of the caption. 

The IFCDIPOO and lEBlOSUP utility programs that were previously 
described in this publication, are now described in IBM System/360 
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Operating System; Starter Operating System Guide , Form C28-6630-1 and 
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time. Any such change will be reported in subsequent revisions or 
Technical Newsletters. 
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INTRODUCTION 



IBM System/360 Operating System is composed of modules that can be 
united in a variety of combinations to meet the given requirements of a 
particular installation. The user selects the programming options that 
meet his data processing requirements and that conform to the proces- 
sing, storage, and input/output facilities of his machine configuration. 
System generation is the process of interpreting the user's selection 
and combining the operating system modules into the system data sets 
that form the installation's new operating system.. 

The new operating system is composed of the standard features 
incorporated in every operating system, those optional features selected 
from the distributed modules, and any additional features provided by 
the user. System generation also provides facilities for adding more 
features to the operating system after it has been generated. 

The system generation process, the system data sets, and the types of 
system generation are discussed in the following sections. 



THE SYSTEM GENERATION PROCESS 

System generation is a process that generates an IBM System/360 
Operating System adapted to both the machine configuration and the data 
processing requirements of an installation. The desired operating 
system is specified by the user through system generation macro- 
instructions. During the system generation process, several operating 
system programs are used to build a new operating system tailored 
according to the specifications in the macro- instruct ions. These 
programs are executed under the control of an existing operating system 
(also called "generating operating system" or simply "generating system" 
throughout this publication) . 

An operating system is generated in two stages (see Figure 1). 
During Stage I, user-supplied macro- instructions that describe both the 
installation's machine configuration and the programming options desired 
are analyzed and used to generate a job stream. In Stage II, this job 
stream is processed to generate the libraries of modules that form the 
user's operating system. These libraries contain modules supplied by 
IBM and, optionally, modules supplied by the user. 



STAGE I: PRODUCING THE JOB STREAM 

Stage I consists of two phases. During the first phase all the 
macro-instructions supplied by the user are analyzed for errors . Error 
messages are written for each error found. If errors are not found in 
any of the macro-instructions, a job stream is produced during the 
second phase. If errors are found, the second phase is bypassed and the 
job stream is not produced. 
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STAGE II: PROCESSING THE JOB STREAM 

During Stage II the job stream is processed by the assembler, by the 
linkage editor, and by utilities. The following functions are 
performed: 

• Selected modules are assembled. 

• The linkage editor combines the modules selected for inclusion in 
the resident portion of the control program (nucleus) . 

• The linkage editor processes those selected modules to construct 
members of the new operating system libraries . 

• Utility programs complete the construction and initialization of the 
libraries selected for the new operating system. 

The generated operating system is then ready for use. 

SYSTEM DATA SETS 

The modules that comprise the operating system are contained in 
system data sets. The system data sets are the system catalog, the 
system libraries, and data sets such as SYSl.SYSJOBQE. The system 
libraries are partitioned data sets. All other system data sets are 
sequential data sets. 

The following system data sets are required for every operating 
system: 

• SYSCTLG (System Catalog) — The system catalog contains pointers to 
all cataloged data sets. 

\ 

• SYSl . NOCIiEUS (Nucleus library) — This library usually contains only 
one member, the resident portion (nucleus) of the control program. 
To include additional mem.bers, see the description of the GENERATE 
macro-instruction in the section entitled "Specifying the System." 

• SYSl.SVCLIB (SVC library) — The members of the SVC library are the 
nonresident SVC routines, the data management access methods, and 
the system's standard error recovery routines. 

• SYSl.LOGREC — This data set is used to record statistical data 
about machine errors. 

• SYSl.LINKLIB (Link library) — The members of the link library are 
programs and routines that can be referred to by XCTL, ATTACH, LINK, 
or LOAD macro-instructions, or by EXEC statements. Nonresident 
operating system programs, e.g., the COBOL compiler, are contained 
in this library. 

• SYSl.PROCLIB (Procedure library) — The members of the procedure 
library include those cataloged procedures used to perform certain 
system functions, e.g., compile- linkage edit-go. 

• SYSl.SYSJOBQE — '■ This data set is used as a work area by the job 
scheduler. 



SYSTEM 
GENERATION 
JOB STREAM 
(CARDS OR TAPE) 




IBM- SUPPLIED 
AND USER- 
WRITTEN 
MODULES 



Figure 1. The System Generation Process 
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The following system data sets are optional: 

• SYSl.MACLIB (Macro library) — The members of the macro library 
include the macro-definitions for the system macro-instructions. 

• SYSl.SORTLIB (Sort library) — The members of the sort library are 
the load modules from which the system produces a sort/merge program 
at execution time. 

• SYSl.ALGLIB (ALGOL library) — The members of the ALGOL library are 
load modules (ALGOL subroutines). 

• SYSl.COBLIB (COBOL library) — The members of the COBOL library are 
load modules (COBOL subroutines). 

• SYSl.FORTLIB (FORTRAN library) — The members of the FORTRAN library 
are load modules (FORTRAN subprograms). 

• SYSI.PLILIB (PL/I library) — The members of the PL/I library are 
load modules (PL/I subprograms) . 

• SYSl . TELCMLIB (Telecommunications library) — The members of the 
telecommunications library are load modules (telecommunications 
subroutines) . 

• SYSl . SYSVLOGX and SYSl .SYSVLOGY (System log data sets) — These data 
sets are used to record write-to-log (WTL) messages before they are 
printed on the system output unit. These two data sets are used 
with multiprogramming with a variable number of tasks (MVT) only. 

The following system data sets are required for system generation 
only: 

• SYSl.GENLIB (Generation library) — This library contains the 
macro-definitions of the system generation macro- instructions. 

• SYSl.MODLIB (Module library) — The members of the module library 
are the load modules from which an operating system is generated. 

The following system data set is originally distributed with the 
starter operating system, and is usually kept in card decks by the 
installation. 

• SYSl.SAMPLIB (Sample library) — The members of the sample library 
are the sample programs used to test operating system components 
(described in the section "Testing the New System") , the independent 
utility programs (IBCDASDI, IBCDMPRS, and IBCFCVRP) , the IPL program 
(lEAIPLOO), a dump program (PROCDUMP) , and an example of writing an 
accounting routine (SAMACTRT) . 

TYPES OF GENERATION 

During each system generation process the user can specify one of 
three types of generation: 

• Complete Operating System generation. 

• Nucleus generation. 

• Processor and Library generation. 

In the first type, the user specifies the generation of an operating 
system consisting of either a control program only, or a control program, 
and language processors and their associated libraries. The control 
program specified can be the primary control program (PCP) , multipro- 
gramming with a fixed number of tasks (MET) , or multiprogramming with a 

10 



variable number of tasks (MVT). Primary data management routines, and 
System utilities are always provided with this type of generation. 
These standard features and the optional features specified are adapted 
to the installation's machine configuration during the generation 
process. An Operating System generation must be performed whenever the 
installation's machine configuration is modified, or whenever changes 
are to be made to the system generation options for the control program. 
(An Operating System generation may not be needed if only changes to the 
nucleus of the control program are to be made. In this case, a new 
nucleus can be added to the operating system through a Nucleus 
generation- ) 

In the other types of generation, the user specifies that a nucleus, 
or that language processors and/or their associated libraries are to be 
added to the operating system. During the preparation for a Processor 
and Library generation, the user must allocate space for, and, if 
desired, catalog, any new system data set to be added to the operating 
system. If any of the existing system data sets are to be modified, the 
user must have allocated sufficient space to those data sets when they 
were initially generated or, where permitted, provided for multiple 
extents in those data sets. (SYSl. NUCLEUS is the only system data set 
affected by a Nucleus generation.) 

During a Nucleus generation or a Processor and Library generation, 
the generating system may also be the system being modified. That is, 
the generating system can add a new nucleus or processors and libraries 
to itself. To faciliate the description of system generation, the terms 
"new operating system" or "new system" are used throughout this 
publication to mean either the operating system generated in a Complete 
generation, or the operating system modified by a Nucleus or a Processor 
and Library generation. 

Figure 2 illustrates the three types of system generation. A 
complete generation is performed first to produce the installation's new 
operating system. A Processor and Library generation is used to add the 
PL/I processor and SYSl.PLlLIB to the new operating system. A nucleus 
generation adds a second nucleus to SYSl. NUCLEUS. 
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Figure 2. Types of System Generation 
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SYSTEM/360 REQUIREMENTS 



To generate an operating system, the installation's machine configu- 
ration and its current operating system must fulfill certain minimum 
requirements. These requirements are described in the following text. 



MACHINE REQUIREMENTS 

The following minimum System/360 configuration is required to gene- 
rate an operating system: 

• 64K bytes of main storage 

• One console device 

• Two direct-access drives (one drive must be either a 2311 or a 2314) 

• One card reader or one magnetic tape drive (input) 

• One card punch or one magnetic tape drive (intermediate output) 

• One printer or one magnetic tape drive (print output) 

OPERATING SYSTEM REQUIREMENTS 

System generation is performed under the control of an existing PCP 
or MFT operating system and is executed as any other job. The operating 
system used to perform a system generation process must have system data 
sets, utility data sets, and, if desired, data sets that contain 
user-written programs to be included in the new system. 

IBM provides a starter operating system that can be used for the 
first system generation. The starter system must be initialized and 
made operational by following the procedures described in Appendix E. 
Once initialized, the starter system meets the system data set require- 
ments listed below and can be used as a generating system. 

SYSTEM DATA SETS 

The generating system must have the following system data sets : 

SYSCTLG (System Catalog) 

SYSl. NUCLEUS (Nucleus library) 

SYSl.SVCLIB (SVC library) 

SYSl . LOGREC 

SYSl.LINKLIB (Link library) 

SYSl.PROCLIB (Procedure library) 

SYSl . SYS JOBQE 

SYSl.MACLIB (Macro library) 

SYSl.MODLIB (Module library) 

SYSl.GENLIB (Generation library) 

The link library (SYSl.LINKLIB) must include an assembler language 
processor (with the alias ASMBLR) , a linkage editor (with the alias 
lEWL) , and the lEBCOPY, lEHMOVE, lEHLIST, lEHIOSUP, and IFCDIPOO 
utilities. SYSl.MACLIB, SYSl.MODLIB, and SYSl.GENLIB must be cataloged 
in the generating system. SYSl.PROCLIB need not be cataloged unless the 
PROCLIB macro-instruction is used during system generation. 

SYSl.GENLIB and SYSl.MODLIB must correspond to the release of the 
operating system to be generated. In certain cases, lEHIOSUP and 
IFCDIPOO must be of the same release as SYSl.GENLIB and SYSl.MODLIB. 
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This information is stated in the Prose material distributed with each 
release of the operating system. 

If the E- design- level assembler language processor is to be used for 
system generation, both the macro library and the generation library 
must be unblocked. SYSl.MACLIB and SYSl.GENLIB can be unblocked by the 
lEBCOPy utility program by specifying DCB=(RECFN5=FB,BLKSIZE=80, LRECL=80) 
in the SYSUT2 DD statement. (For a description of lEBCOPY and of the 
control statements it requires, refer to the publication IBM System/360 
Operating System; Utilities . ) 

If the new operating system is to have ALGOL, COBOL, FORTRAN, PL/I, 
or sort/merge processors, the necessary processor modules must be 
included in the module library (SYSl.MODLIB) . However, the generating 
system need not have the actual processor to generate it for the new 
system. For example, to generate a system that contains a FORTRAN 
compiler, the generating system need not have a FORTRAN compiler, but 
the FORTRAN compiler modules roust be in SYSl.MODLIB. 

If SYSl.COBLIB (for COBOL E) , SYSl. FORTLIB, SYSl.PLlLIB, or SYSl. 
SORTLIB is to be included in the new system-, that library must exist as 
a cataloged partitioned data set in the generating operating system. 
SYSl.ALGLIB, SYSl.COBLIB (for COBOL F) , and SYSl.TELCMLIB need not exist 
as cataloged partitioned data sets in the generating system, but their 
modules must be included in SYSl.MODLIB. The modules for SYSl. FORTLIB 
must also be included in SYSl.MODLIB. 

If the installation's operating system does not have SYSl.GENLIB and 
SYSl.MODLIB, they can be obtained from any generating system (either 
from the starter system or from any other operating system, that meets 
these system data set requirements) . If enough drives are available in 
the system, SYSl.GENLIB .and SYSl.MODLIB need only be cataloged in the 
generating system using the lEHPROGM utility program. If there are not 
enough drives available, either SYSl.GENLIB or SYSl.MODLIB, or both, 
must be copied onto a generating system volume using the lEHMOVE utility 
program, and then cataloged. An example of obtaining SYSl.GENLIB and 
SYSl.MODLIB is in the section "Examples." 

The arrangement and contents of the generating system data sets 
determine the performance of the system generation process. In general, 
any factory that contribute to faster assemblies and link edits will 
also contribute to faster system generations. For example, having 
resident supervisor functions such as BLDL and RAM; or having SYSl. 
LINKLIB reside on a volume other than the system residence volume. 



UTILITY DATA SETS 

In addition to the system, data sets, four utility data sets must be 
allocated space and cataloged in the generating system for use during 
the system generation process. Each of these data sets must be 
cataloged as SYSl.name, where the value of name must not exceed eight 
alphameric characters, the first of which must be alphabetic. Three of 
these data sets must be sequential data sets; the fourth roust be a 
partitioned data set. One of the sequential data sets and the 
partitioned data set must reside on a direct-access volume. The 
assembler, linkage editor, and utilities use the three sequential data 
sets during system generation. The partitioned data set is used for the 
storage of object modules assembled during system generation. (See 
"Input Deck for System Generation" in the section "Specifying the 
System" for further details on the utility data sets.) 
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USER-WRITTEN PROGRA^iS 

During the system generation process, the user can include his own 
routines in the nucleus, SVC library, and/or link library of the new 
operating system. The routines to be included in each of these 
libraries must be merabers of partitioned data sets cataloged in the 
generating system. The names under which they are cataloged are of the 
form SYSl.name. There must be only one partitioned data set for each of 
the libraries to be modified. However, if more than one library is to 
be modified, all routines can be included in one partitioned data set. 

The user specifies the inclusion of his routines in the appropriate 
libraries by using the RESMODS, SVCTABLE, SVCLIB, and/or LINKLIB macro 
instructions. (See the section "Adding User-Written Functions.") 
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PREPARATION FOR SYSTEM GENERATION 



Before an operating system can be generated, a new system residence 
volume, and any other direct-access volumes required, must be initial- 
ized. The highest level of the system catalog must be built on the new 
system residence volume. Space must be allocated for the appropriate 
system data sets in the new operating system, and the appropriate data 
sets must be cataloged in the new system catalog. By definition, the 
system residence volume is that volume on which the nucleus library, the 
SVC library, the IPL program, the SYSl.LOGREC data set, and the volume 
index of the catalog are located. 

Volume initialization is performed by the IBCDASDI independent 
utility program. The lEHPROGM system utility program is used to build 
the volume index of the system catalog, to allocate space for system, 
data sets, and to catalog data sets. This system utility can be 
executed at any time after the system residence volume is initialized. 

The following paragraphs describe the initialization of the system 
residence volume and other required direct-access volumes, the initiali- 
zation of the system data sets, and considerations on allocating space 
for these data sets. Detailed descriptions of the utility programs and 
o£ the control statements they require are found in the publication IBM 
System/36 Operating System: Utilities . 



INITIALIZING DIRECT-ACCESS VOLUMES 

Initialization is the process of writing home addresses, a volume 
label, and a volume table of contents (VTOC) on direct-access volumes. 
In addition, the initial program load (IPL) program must be written on 
the direct-access volume that is to become the system residence volume. 
Tiiese functions are accomplished by the direct-access device initializa- 
tion (IBCDASDI) utility program. This utility program is self-loading 
and operates independently of the operating system. In addition to its 
initialization functions, this utility program checks for defective 
tracks and, if any are found, assigns alternative tracks and issues 
appropriate messages. Alternative tracks are not accepted for track 
of the system residence volume. (Track is required for the IPL 
program.) If. track is found defective, another volume must be 
initialized for system residence. 

The IPL program (lEAIPLOO) is originally distributed with the starter 
operating system. Appendix E describes the procedure used to punch the 
IPL program cards from the distribution libraries. These cards can then 
be inserted in the IBCDASDI input deck whenever a system residence 
volume is initialized. 

Figure 3 is an example of an input deck for system residence volume 
initialization. In this example, the volume to be initialized resides 
on an IBM 2311 Disk Storage Drive. The volume serial number to be 
written in the label is 111111. The volume table of contents (VTOC) 
starts at track 2, and is eight tracks long. 

Note: If the direct-access volume is being initialized for the first 
time, the parameter FLAGTEST=NO should be included in the DADEF 
statement. 
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Sample Coding Form 


1-10 11-20 21-30 31-40 41-50 51-60 61-70 71-80 


1|2|3|4|5|6|7|8|9|0 1 |2|3|4|5|6|7|8|9|0 1 |2|3|4|5|6|7|8|9|0 1 i2|3|4|5|6|7|8|9|0 I|2|3|4|5|6|7|8|9|0 1 |2|3|4|5|6|7|8|910 1 |2|3|4|5|6|7|8|9|0 1 |2|3|4|5|6|7|8|9|0 


V,0,L,I,N|IT JP|B, ,,, 1 ,,,,,, , -S|YSTEM, ,R,E,S,I|DEN,CE| yp,L,U|ME, 


,IN|I,TI,A,L|I,Z,ATI|QN- , , , , 




1 , , 1 . . . , 




, , , M,S|G, , , , ,T,O,D,EVpl,4,0,3i5T,O,A,D|O,R=0,0,E, ,,,,,,,,,, , 


, , -ME,S,S,A,G,E, ,0|U,T,P,U,T,- , 










, , , ,D,A,D,E,F, , ,T,0,D,EVr2,3,l,l,)TAA,D,D,R-,l,9,l,rI,P,Lr,Y,E,S,5, , , 


, , |-V,0,L,U,ME, ,,,,,,,),, 


, , 1 ,x, , 








, 1 , , , , ,VAL,I,D|^S,CR,A,T,C,H, ,,,,,,,,,,, ,,,,,,, , 




, , ,D,E,F,I,N,I|T,I,0,N,- , , 












YL|D, , , , ,M,EyyV,0|L,I,D = l,l,l,lll|rOWNE,R,I,D=0|E,P,T,8,9, , , 


1 1 r 


V,0,L, ,LA,B,E,L| ,D,E,F,-| , , 












V,t|0,C,D, , |S,T,R,T,A|D,R,=Z,0|E,X,T,E,NiT=,8, , i ,,,, | ,,,,,, , 


1 1 r 


V,T,0,C| ,D,E,F,I|HI,T,I,0|N,- 












I PLTXT 












•J,X,T 


\ 


















. 1 < . . . 1 . > 1 . 1 < , , , 1 , . < , 1 , 1 , < 1 < < 1 1 1 < < 1 , 1 , 1 














\m 


,PR,0,G,R,A,M, ,(,I.E|AIPL0,(2I, CAR|DS,), , , , , , , , , , , , , , , 




























•T,x,T 
















.,E,N,D 
















1 1 1 


1 1 1 


, i ,. , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , 


, , 1 


< 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 









Figure 3. Initializing the System Residence Volume 



INITIALIZING SYSTEM DATA SETS 

The initialization of system data sets is the process of allocating 
space to the system data sets, building the volume index of the system 
catalog, and cataloging system data sets in the system catalog. The 
contents of the system libraries are placed in the allocated space 
during system generation. The contents of the other data sets are 
placed in the allocated space during job execution time in the generated 
operating system. 

The volume index of the system catalog is built on the new system 
residence volume by the lEHPROGM system utility program. This index 
points to the system data sets that will form the new operating system. 
These data sets can be cataloged by the same utility program. Space 
should be allocated for these data sets (except for SYSl.LOGREC) by DD 
statements included in the input to this system utility program. The 
amount of space to be allocated to each system data set is shown in the 
publication IBM System/360 Operating System; Storage Estimates . The 
following sections describe the data sets for the new system, the input 
deck for initialization, and guidelines for the allocation of space to 
the system data sets. 



DATA SETS FOR THE NEW SYSTEM 

The following system data sets are required, and must have space 
allocated on the system residence volume. These data sets need not be 
cataloged. However, it is recommended that at least one of these data 
sets be cataloged to permit references to the system residence volume 
without knowing its serial number. (These references can be made by 
specifying VOLUME=REF=dsname in a DD statement, where dsname is the name 
of the cataloged data set.) 

• SYSCTLG (System Catalog) — Only the volume index of the system 
catalog need reside on the system residence volume. 

• SYSl. NUCLEUS (Nucleus library) 
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• SYSl.SVCLIB (SVC library) — It is recommended that this data set be 
cataloged because some cataloged procedures use its name to refer to 
the system residence volume. 

• SYSl.LOGREC — Space must not be allocated for this data set by the 
user. (SYSl.LOGREC is allocated space and initialized during the 
system generation process. Information on this data set is supplied 
in a message during Stage II of the system generation process. If 
SYSl.LOGREC must be reinitialized after system generation, refer to 
the description of the IFCDIPOO utility program in the publication 
IBM System/ 360 Operating System; Utilities . ) 

The follow^ing system data sets are required, and must have space 
allocated on a direct-access volume. They need not reside on the system 
residence volume. 

• SYSl.LINKLIB (Link library) — This data set must be cataloged. 

• SYSl.PROCLIB (Procedure library) — It is recommended that this data 
set be cataloged. It must be cataloged if any of the residency 
options or link pack area options are to be used. These options are 
described in the section "Residency Options and the Link Pack Area" 
of the publication IBM System/360 Operating System; System Program- 
mer's Guide . 

• SYSl.SYSJOBQE — This data set need not be cataloged. 

The operating system can function without the following system data 
sets. If the user wishes to make use of the optional facilities they 
provide, they can be included in the new operating system. Space must 
be allocated on a direct-access volume for the optional data sets 
desired. They need not reside on the system residence volume. It is 
recommended that the data sets to be included be cataloged. 

SYSl.MACLIB (Macro library) 

SYSl.SORTLIB (Sort library) 

SYSl.ALGLIB (ALGOL library) 

SYSl.COBLIB (COBOL library) 

SYSl.FORTLIB (FORTRAN library) 

SYSl.PLlLIB (PL/I library) 

SYSl.TELCMLIB (Telecommunications library) 

SYSl . SYSVLOGX and SYSl.SYSVLOGY (MVT system log data sets) — These 
data sets must be cataloged 



INPUT DECK FOR INITIALIZATION 

The system data sets are allocated space and cataloged by the 
lEHPROGM utility program. Detailed descriptions of the control cards 
and functions of lEHPROGM can be found in the publication IBM Svstem/360 
Operating System; Utilities . The following text only describes the use 
of lEHPROGM for initializing the system data sets. 

The input deck for lEHPROGM must contain the following; 

• JOB statement with any parameters required by the installation. 
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• EXEC statement with the PGM=IEHPROGiyi parameter. 

• A DD statement for the message output data set (SYSPRINT) . 

• A DD statement for each of the new system data sets (except for 
SYSl . LOGREC ) . These DD statements have the following format: 

//ddname DD DSNAME=dsname,VOLUiy!E= (, RETAIN, SER=serial) , X 

// UlSIIT=unit, LABEL=EXPDT=99350,SPACE= (allocation) , X 

// DISP=(, KEEP ),DCB=( see Table 1) 

• A DD * Statement (SYSIN) . 

• A CATLG Statement for each new system data set to be cataloged. 
Each CATLG statement must have the following format: 

CATLG DSNAME=dsname,CVOL=unit=serial,VOL=unit=serial 

The DD statements and CATLG statements are described below. A 
section with examples of allocation is also included. Table 1 lists 
each system data set and summarizes allocation and cataloging require- 
ments. For more information on the coding of these parameters refer to 
the publication IBM System/360 Operating System: Job Control Language . 
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Table 1. System Data Sets 
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DP Statements 

The DD statements in the input deck for initializing the system data 
sets have the following parameters : 

ddname 

name of the DD statement. 

DSNAlvlE=dsname 

name of the system data set. There must be a DD statement for each 
required system data set (except for SYSl.LOGREC) , and for each 
optional system data set selected. 

SYSl.SYSJOBQE, SYSl . SYSVLOGX, and SYSl. SYSVLOGY are not affected by 
system generation. Therefore, they need not be allocated space and 
cataloged until before the initial program load (IPL) of the new 
system. For convenience, it is recommended that they be allocated 
space and cataloged together with the other system data sets . 

During the preparation for processor and libraries generation only 
those optional system data sets that are to be added to the system 
must be cataloged and allocated space. 

VOLUME= ( , RETAIN, SER= serial) 

serial number of the direct-access volume on which the system data 
set is to reside. The serial number of the new system residence 
volume must be specified for SYSCTLG, SYSl. NUCLEUS, and SYSl. 
SVCLIB. The volume indicated with this parameter determines the 
corresponding volume specification for the system data set in the 
system generation macro- instructions. (See the descriptions of the 
GENERATE, PROCLIB, TELCMLIB, lyiACLIB, ALGLIB, SORTLIB, COBLIB, 
FORTLIB, and PLlLIB macro-instructions in "Specifying the System.") 
The section "Location of System Data Sets" provides guidelines for 
the allocation of system data sets on available volumes. 

aNIT=unit 

the name of the direct-access device that can be allocated to the 
system data set. It is recommended that the value given to UNIT be 
a generic unit name. (Generic unit names are listed in 
Appendix C.) 

LABEL=EXPDT=99350 

the expiration date for all data sets (except for SYSl. SYS JOBQE) is 
chosen to prevent accidental deletion. The DD statement for 
SYSl . SYS JOBQE should not have an expiration date because this data 
set must have an expiration date lower than the date entered during 
IPL for the new system. 

The data set protection provided by the expiration date requires 
additional action by the user. If the current date is set in the 
generating system during system generation, the operator is 
required to override this current date each time a protected data 
set is opened. Another, more convenient method can be used. For 
the system generation job (or any time the data sets are to be 
modified) , the current date may be set at a higher value than the 
expiration date specified for the protected data sets. (In this 
case the set date becomes the new expiration date.) This may, be 
done by the operator from the console, or by a card in the job 
stream. In either case, the current date should be reset in the 
generating system immediately after the completion of the system 
generation process. 
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SPACE 

the amount of auxiliary storage to be allocated to the system data 
set can be obtained from the publication IBM System/360 Operating 
System; Storage Estimates . The directory quantities for the 
system libraries are also shown in that publication. 

The user must also allow space for the inclusion of his own 
programs into the system data set during (or after) system 
generation. Some system data sets, such as SYSl.LINKLIB, may not 
have a secondary allocation and must be contiguous. Thus, suffi- 
cient space must be initially allocated to them if user modules are 
to be included. Table 1 indicates which system data sets may not 
have a secondary allocation. To insure that these data sets are 
also contiguous, the SPACE parameter may be coded as follows: 

SPACE= (units (quantities) , ,CONTIG) 

Only the volume index of SYSCTLG must reside on the system 
residence volume. SYSl. NUCLEUS and SYSl.SVCLIB must be allocated 
space entirely on the system residence volume. SYSl.SVCLIB may not 
occupy more than 1023 tracks on the system residence volume. (The 
size of SYSl.LOGREC is determined during system generation and is 
allocated on the system residence volume.) The maximum space that 
can be allocated to the remaining system data sets is one volume, 
except for SYSl. SYSJOBQE which may not occupy more than 1250 tracks 
on a 2314. Alternative track assignment is accepted for the system 
data sets. However, to achieve maximum efficiency in the new 
system, alternative tracks should not be used for SYSl.SVCLIB, 
SYSl . LINKLIB , and SYSl. SYSJOBQE. 

Space must be allocated for SYSl.PROCLIB in the new system. If 
neither IBM-supplied nor user-written cataloged procedures are to 
be used with PCP or MET, a null allocation can be made for 
SYSl.PROCLIB; i.e., the SPACE parameter is specified as SPACE=(TRK, 
(0)). A null allocation is not permitted if MVT is used in the new 
system, because a minimum of three cataloged procedures are 
required for MVT. (The three cataloged procedures are named 
lEEVMPCR, lEEVRPCR, and lEEVWPCR.) 

Unless sufficient space is allocated to the system data sets, the 
system generation process cannot be completed successfully. 

DISP=(,KEEP) 

this parameter must be coded as shown. DISP=(,CATLG) cannot be 
used because the data set would be cataloged in the generating 
system rather than in the catalog of the new system residence 
volume. 

DCB 

certain system data sets require a DCB parameter- The values to be 
given to this parameter are shown in Table 1 for the appropriate 
system data sets. 



CATLG Statements 

The CATLG statements in the input deck for initializing system data 
sets have the following parameters: 

DSNAME=ds name 

the name of the system data set to be cataloged. Table 1 shows 
whether a system data set should be cataloged. 
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CVOL=unit=serial 

specifies the unit name and serial number of the new system 
residence volume. (The values must be the same as specified in the 
DD statement for SYS 1 .NUCLEUS.) 

VOL=unit=serial 

the unit name and serial number of the volume on which the system 
data set resides. These values must be the same as specified in 
the corresponding DD statement for the system data set. 

Sample Data Set Initializations 

This section contains two examples of initialization of system data 
sets. In the first example, all the system data sets required by a new 
system reside on one volume. In the second example, the system data 
sets of another new system are arranged on two volumes. The numbers 
chosen for space allocation in these two examples are for illustrative 
purposes only . Space requirements for the system data sets are 
determined by several factors, especially the type of device used and 
the characteristics of the system to be generated. For example, the 
processors chosen for the new system affect the size of SYS1 .LINKLIB. 
Exact auxiliary storage requirements on various types of direct-access 
devices can be obtained from the publication IBM System/36Q Operating 
System: Storage Estimates . 

Figure 4 is an example of an input deck for building the system 
catalog and for allocating space to the system data sets on one volume . 
It is assumed that the system residence volume was initialized as shown 
in Figure 3. The new system requires SYS1 .MACLIB, SYS1 . SORTLIB, 
SYS1.C0BLIB, and SYS1 .FORTLIB. These optional data sets, and SYS1. 
SVCLIB, SYS1.PR0CLIB and SYS 1. LINKLIB are to be cataloged in the new 
system. The unit for the new system residence volume is a 2311. The 
serial number of the system residence volume is 111111. 

Figure 5 is another example of an input deck for building the system 
catalog and for allocating space to the system data sets. The system 
data sets are to reside on two volumes . The unit for the system 
residence volume is a 2301 and its serial number is AAA111. The unit 
for the second volume is a 2311 and its serial number is AAA112. It is 
assumed that both volumes were previously initialized. The new system 
requires all the optional system data sets. These optional data sets, 
SYS 1. SVCLIB, SYS1.PR0CLIB, and SYS 1 .LINKLIB, are to be cataloged in the 
new system. All system data sets, except SYS 1 .LINKLIB, SYS 1. MACLIB, 
SYS1.SYSVL0GX, and SYS1 .SYSVLOGY, reside on the system residence volume. 
SYS 1. LINKLIB, SYS 1. MACLIB, SYS 1 .SYSVLOGX, and SYS 1 . SYSVLOGY reside on 
the second volume (AAA112) . 

LOCATION OF SYSTEM DATA SETS 

This section provides guidelines for allocating space to the data 
sets required by the new system, and to the four utility data sets 
required during system generation. (Two of the utility data sets must 
reside on direct-access volumes; the other two may reside on either 
magnetic tape or direct-access volumes.) The location of the new system 
data sets is determined by: 

• The size of the system data sets (given in the publication IBM 
System/360 Operating System: Storage Estimates ) . 

• The size of the utility data sets required for system generation 

(given in the section "Input Deck for System Generation.") 

• The machine configuration, in particular the number and type of 
devices available in the generating system. 
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Sample Coding Form 




l-IO 11-20 21-30 31-40 


41-50 51-60 61-70 71-80 




Il2l3l4l5l6l7l8l9l0 1 12|3|4|5|6|7|8|9|0 1 |2|3I4I5I6I7I819I0 1 I213I4I5I6I7I8I9I0 


Il2l3l4l5l6l7l8l9l0 1 |2|3|4I516I7I8I9I0 1 I2I3I4I516I7I8I9I0 1 I2I3I415I6I7I8 


9i0 


//SYS,GEN JOB 1 M5G,L|EyEL=,l , -AL,LOCAT,E ON pNE y,OLUME- ,,,,,,,,,,,,,,,,, 




^ 


//STE|P0 


EXEC, PGM=;iEHPR,oGM ; , ; , ; , ; , 

J 1 1 1 1 1 > 1 1 1 1 1 1 r 1 1 1 1 1 1 J 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 > 1 1 1 I 1 1 1 1 1 1 


1 1 1 1 






/,/5Y5|PRINT| 


DD 5Y5ou;t=a I ; 1 ; 1 ; , , , , l , , , 


III 






/,/JpB,QE, , , 1 


DD P5NAV(E= 5YS,1 .SY5;JOBQE»VOLU;ME=( '.RETALN » S,ER|=ll,l,i;i 1,),» , , , , 


1 '^' 1 




, 


/,/,,,,,,,, 


,UNIT=,2311»,DISP=;(.KEEP)»SP;ACE=(|TRK»(;i20)»|»CONriG) , , , , , 


1 1 1 1 




, 


//SVCLIB I 


DD PSNAIVE=SYS1.5VC;LIB,V,0LUIV1^=(» RETAIN »;SER= 1,11 lli;)» , 


, X 


,1,1 






iUNIT=2311,,DI5P=;C»KEE,P),SP;ACE=(|TRK»(;150, »75),,C0NTI|G),, 


1 X 

III 








,LABEL;=EXPD|T=993;50,OC,B=(D5ORG=P,OU»RE;CFM=U|»BLKS;IIE= 1,024) 








//LIN,KLIB 1 


DD ,DSNAME=SYS,l.LIN;KLIB,yOLUN/E=(»R,ETAIN;,5ER=|lllll'l)» , 


1 X 

III 






/,/,,,,,,, 1 


,UNIT=;231l7,DISP=;^ KEEP) ,SPACE=(,TRK»(;970,,, 100) »;»CONT,IG), 


1 X 

III 








iLABEL;=EXPDT=993;'70,DC,B=(RE;CFM=U|,BLK^I2E=5,625) ; , , , , , , 


1 1 1 1 






//CATALOG 1 


DD ,DSNAh/(E=SYS,CTLG,;V0LUME=(,R;ETAIN|,5ER=;iUll,l), , ; ,,,,, , 


1 X 








,unit=;23ii»pisp=;(,kee,p),sp;ace=(,trk,(;i0,i),), ; , 


l,^, 






//.,,,,,, 1 


,LABEL;=EXPDT=993;50 , 










//PRO,CLIB ; 


DD ,DSNAME=5YS,1.PR0;CLIB,,V0LUM 


E=(, RETAIN,, SER=,11111,1), , 


, x 






// 1 1 


,UN1T=2311i,DISP=,(»KEEP),SP;ACE=C,TRK,(;3(2(,10,,9)),; , 


1 X 








,LABEL;=EXPDT»993;50,DC,B=(RE;CFM=F,»BLKS;iZE=a0) ; , 


1 1 1 1 






//Sq^TLIB, 


DD P5NAI\/(E=SYS1.S0R;TLIB, ,VOLUIVJE=(, retain;, 5ER=,lllli;i)» , , 


1 X 






/./,,,,,,,, 1 


,UNIT=2311vDISP=,(»KEE,P),SPACE=(TRK,(,60,2,,4-O)),; , 


1 X 

III 






//, , , 1 , , , , 1 


,LABEL;=EXPPT=995|50vDC,B=/RE,CFM=U,vBLKS,IZE=3,625), ;,,,,,,,, 


1 1 1 1 






//CPALIB , 1 


DD pSNAME=5YS,l.C0B,LIB»V,0LUME,= (, RETAIN, ,SER- 1,111 11,), , 


- . 






1 1 1 1 1 1 1 1 1 1 


,UN1T=2311»PI5P=;(,KEE,P),SP;ACE=(,TRK,(;35,2,,30))»; 


1 x 








,LABEL=EXPD|T=993;50,DCB=(RECFM=U,,BLKS;iZE=3,625) ; , 

1 1 I 1 1 I 1 1 1 1 1 1 1 1 1 1 J II 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 








//FOR,TL,IB 1 


DD P5NAN/E=SY5,1.F0R;tLIB,,V0LUME=(. retain;, SER=,1 11 li;i), , 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


1 X 






//. . 1 


, , , PN;J=:2AU,,,P1SP=|(,^KEE,P,),vSP,AAE=(,TRK,,(|5^ ,,,,,,,, 


|,X,, 






1 1 1 1 1 1 1 1 1 1 


, , , iLABEL=EXPDT=993;50,DCB=(RE;cFM=U,,BLKS;IZE=3,625) ; , 








//MACLTB 1 


PP , ,DSNANE=SY5|l.MAC;LIB,y,0LUM^=(.,,R^TAlN,i5ER=l^ ,.,,,, 


1 X 






1 1 1 1 1 1 1 1 1 1 


, , , pNIT=2311,pi5P=|(,vKEEp),,5P^CE=^TRK,(%^^^ , , , , , , 


1 X 






' i' 1 1 1 1 1 1 1 1 1 


, , , ,LA,BAl.=AXPP,T=993;5,0,,pCA=(RE|CFM=F,B,vBLK^^^^ 








//NUCLEUS , 

' 1 1 1 1 1 1 1 1 1 1 


PP , pSNANE=SYS,l.NUCLEUS,ypLUME=(,,R,ETAIN. , , , , , 


1 X 






1 1 1 1 1 1 1 1 1 1 


, , , ,UNJT=2311,pJ5P=|(,^KEE,P),^SP|ACE=^TRK^(p,0,,,,l,),^ , , 


|,X, , 






L 1 1 1 1 1 1 1 1 1 


iLABEL=EXPD,T=993;50 , 

< 1 1 1 1 1 1 >n 1 1 1 1 1 1 1 1 1 ri 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 








//sYsiN ; 


DD 1* ; -input; for CATALOGING, SYStEM DATA SETS- , 








catlg: 

1 1 1 1 1 1 1 1 I 


CVpL=23;il= 11,11 11, ;V0L=2,311 = i;i1111,,DSNA;ME=SY,S1.LI;NKLIB 








iCATLG 


, CypL=23;il=,ll|li;i,,;yOL=2|311=i;i;il),,pSNAME=SY,S;,.P^^^^ 








.catlg 

1 1 1 1 1 1 1 1 1 


Cy0L-23;ii = ll,llll,;V0L=Z311-i;illll,,D5NAME=5Y,Sl.M/^CLIB , 

1 1 1 1 i 1 1 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 








catlg; 

1 1 1 1 1 1 1 1 1 


Cy0L=23;il = ll,llll,;V0L=2,311=i;illll,,DSNAME=SY,Sl.S0;RTLIB, 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 J 1 1 1 1 1 J 1 1 1 J 1 r 1 1 








CATLCi 

1 1 1 1 1 1 1 1 1 


, cypL=23;u=i,i,n,n,,;yoL=2,3ii=);niii,vDSNAME=SY,sA.^^ , , , , 








catlg; 


Cy0L=23;il=ll,llll,;V0L=Z,311 = i;illll,,D5NAlVIE=SY,51.F0;RTLIB, 








, , , , PATLfi 


, cypL=23;ii= 11,1111, ;yoL=2|3ii-i;ii 11 i,,dsna;me=sy,si.sv;clib , 








/x , , 

1 1 1 1 1 1 1 1, 1 1 


1 1 1 1 1 1 1 1. 1 1 1 1 .' ' 1 1 1 1 1 1 1 1 1 1 1 ' ' ' 1 1 ' ' ' ' 1 ' ' ' ' 1 ' ' ' ' 1 ' ' ■ ' 1 ' ' ' ' 1 ' ■ ' ' 




1 1, , 


^ 



•Figure U. Initializing the System Data Sets — One Volume Residence 
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Sample Coding Form 



20 21-30 31-40 41-50 51-60 ^'''^'O 

6|7|8|9|0|l|2|3|4|5|6l7|8|9|0|l|2|3|4|5|6|7l8|9|0lll2l3|4|5|6|7|8|9|0|l12|3|4|5|6|7|8|9|0|l|2|3|4|5|6|7|8|9|0 



71-80 

I|2|3|4l5|6|7|e|9|0 



I|2|3|4|5|6|7]8]9l0 



//SYS.GEN 



JOB 



MSGL,EVEL=1 



-A L,LOCATE OM ,TWO ypLUIVlE,S - 



//ONE, 



EXEC 



PGM=IEHPR,06M 



//SYSPRINT, 



DD 



,SYSOUT=A 



//JOB,QE 



DD 



DSNAIAE=SYS,1 . SYS,JOBQE,WOLU,ME= ( rRETAI,NiSER,= AAAl,l 1 ) 7 

■ ■ ■ ■ T ■ ■ ■ ■ I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I I 



m 



II 



UNIT=,2301^,DISP=,( jKEE.P) )SP,ACE = (,TRK)(,30) ) ),CONTIG) 



/./SYCL.IB. 



DD 



DSNAM,E=SYS,l.SYC,LIBW,0LUMEr(iRETAINvSER = A,AAlll,)7 



// 



UWIT=2301rDISP=,(jKEE,P)^SP,ACE = (,TRI<7(40n7,5)nC,ONTIG,) 



// 



LABEL = EXPD,T=993,507DC,B=(D5ORG = P,OU?RE,CFM=U,iBLKS,I2E = l,, 



,024) 



/./ ,C,AT|A,L,0 ,G. 



DD 



DSNAIAE=SYS,CTLGi|VOLUME = (iR,ETAIN,)SER=,AAAll,l)) 



/,/. 



,UNIT=,2301rLABEL=EXPDT=?93,50)SP,ACE=(TRI<-)(,2il)),) 



J I f III 



I I I I i_ 



I I I I I I 



DISP=|()KEE|P) 



//PRQCLIB 



PD 



fiS,NA,/^E=,SXS,l,vP,Rp|C,LJ,B,)yp,LMI^E,=,(;,R,ETAIN,vSER=AAAj;|l,),), 



// 



I . . 



UNIT=,2301rLABEL=EXPDJ=993,50)SP,ACE = (JRK) (,8)2)9,))) , 

•■■■'■•■ I I I I I I I I 1 I I I I I I I I I I I I I I I I I I I I I I I I I I I I 



// 



DISP=,()KEE,P))DC,B = (RE,CFM=F,)BLKS,IZE = 8,0) 



//SORTLIB 



DD 



// 



DSNA,>/^E=SYS|l,.SpR|TLIB)|VpLUM|E=,(,)R|ETAI,Np$ER=,AAA , )^ 



UNIT=,2301),LABELrEXPD,T=993,50)SP,ACE = (,TRK)(,15)2),40)))| 



I I f I I I I ,1 



pISP=()KEEP))DCB=(RE,CFM=U,)BLKSlZE=2,08'43), 

I .... I .... I .... I ... . J I I |__| [^_, I I I |_ 



//COBIIB 

I I I I I I I 



DD 



DSNA/AE=SYSl.COB,LIBDVpLUME=()RETAINrSER=A,AAlll,)o , 

■ ■ ■ i— J — 1—1 I I I I I I I I I I I I I I I I I I I I I I I I l_l l_J i_l I I I LJ 1_L 



\M 



I I I I I I 1 .1.., 



UNIT=2301yLABEL=E-XPD,T = 99350)SP,ACE = (TRK)(,10)lr30))r 



.1 I I III La 



// 



I I 



DISP=,()KEE,P))DC,B=(RE,CFM=U,)BLKS,IZE = 2,08'43), 



//FORTLIB 



DD 



PSNAME=SYS,1.F0R,TLIB),V0LUME=()R,ETAIN,)5ER=,AAA111)7 

I I I I ] I I I I I I I I I I I I I I I I i I I I I I'l I I I I I I I I I I I I I I I I I 1^1 



/,/. 



UNIT=,2301rLABELrEXPDT=993,50)SP,ACE = (,TRl<)(,12)2),40))) 



J L_J I L_l_ 



// 



_l_l I I .J,. 



DISP=,()KEE,P)oDC,B=(RE,CFM=U,)BLKS,IZE= 20843) 



J I I I I LJ_ 



/./P.LliLI.B. 



DD 



DSNAME = SYS,l.PLl,LIB)VpLUME=(^RETAINvSER=A,AAlll,)) 

I I I I I I I I I I I I I 1 I I I I I I I I 11 I I I'l I I I I I 1^1 I I I I I I I I I 1^1 



//, 



UNIT=|23.0,b|L.A,B,E,LpEXPP.T:-.993 , 50,)SPACE=,( | TRK).(|20,)10)6,5),),) 



/,/ 



DISP=|(il<EE,P))DC,B=(RE,CFM=U,5BLI<S,IZE=2,0843), 



//AL,G|L,I,B, 



PD 



DS 

I I I I 



E=SYS,l.ALG,LIB)VpLUME|=()REJArNrSER = A,AAlll,)) 



/,/, 



UMI.T,= | 23,01.yLA,B.E,Lr,E,XP.D|T=9.9,3|5.0.)SP,A,C,E = (|TRX),(,l,0,).2,),l,5,),),), 



// 



iDISP=,(i KEEP) )DC,B=(RE,CFM=U,)BLKSIZE = 2,0.843), 



/,/TEL,C,L.I.B 



DD. 



pSMAM | E,^SyS|l,.TEL , CMLI,B,)ypLU,M,E=(;|R,ETAI,N)SER|=AAAl , ll,^ 



/./, 



UNIT,=|2301;|LAB,ELrE,XPD|T=993,50)S,P|ACE.= (,TR,KU,10)l)|10) ) ), 



// 



I , 



DISP= , (,^KEE|p;;pCB=^RE|CFM=UpBL,KS|IZE = Z08,43,), 



//NUCLEUS 



I I I III 



DD 



DSNAM,E=SYS,1. NUCLEUS ),V0LUM|E = ()R,ETAIN,)SER=,AAA1 1,1)) 

I I I I I — L_L. L I III I — I I I iM I I I I I 1^1 I I I I I I 'l I I I I I I I II' i'l 



//, 



I I 



UMIJ=|23,01.^iSPAp,Ep,(TR,Kir(10,) | ),l,),),),Cp,NTI , G),), 



/,/, 



fiISP=,(,o,KEE|P,),),LA|BEL = E|XPp,T=,9935)2f, , , , 



//LIN,KLIB 



DD 



PSNAME=SYS,i. LIN,KLIB),VOLU 

I I I I I I I I I 



E=()RETAINSSER=AAA112)) 



I I I I I I I I 



,UNIT=2311 )PISP= ( )KEE,P) oSPACE=(,TRK) ( 1250),)100);) )CON,TIG) 

1 . . . . j_j — 1_| |_] I I I I I I I I I I I I I I Lj I i_i L_i 1—1 I L ' ' ' 



// 



LABELrEXPDT=993,50)DCB=(RECFM=U,)BLI<S,IZE=3,G25) 

I. I I I I ,1 I I I I, I I ri I I, 1 ,1 I I I I ,1 I I I I, I I I.J 1 ,1 I I, I I I I I 



Figure 5. Initializing the System Data Sets — Two Volumes Residence 
(Part 1 of 2) 
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Sample Coding Form 



l-IO 



11-20 21-30 31-40 41-50 .51-60 ^.'"'^O 

1 12|3|4|5|6|7|8|9|0| I |2|3|4|5|6|7|8|9|0| I |2|3|4|5|6|7|8|9|ol I |2|3|4|5|6|7|8I9I0| I I2I3|4|5|6|7|8|9|0| I12|3|4|5|6|7I8I9I0| I I2l3|4l5l6l7 



I9l9f^ 



I I2I3I4I5 



80 , 

6I7I8I9I0 



//MAC! IB 

I I I 



DD pSNAME=S^^ 



,UNIT=;231ivLABEL:=EXPDT=993;50jSPACE = (;TRK')(,M40)5,0?25),) 

J I L_l lJ l_l I I l_] LJ I 1_] l_l l_] I I I I I L-J L 



ti) 



,DISP=(^KEEP)^DCB-(RECFM=FBTBLKSIHE = 3360rLRECL=8t,, , 



/MVT,Lp6X 



DD 



,DSNAME=SYS,l.SYSyL0GX,W0LUME=(vRETAINiSER=AAAl,12)^ , 

I I I I I I I I I I I I I I I I I I I I I I I I I I I I I r I I I r I I I I I I I I I I I I I I 



,UNIT= 2311 rSPACE,= ( 120,1 (l#,)nCO,NTIG),) 



I I 



,DISP = (iKEE,P))LABEL = E,XPDT=99350, 

' ' • ■ ■ ' I I I I I ] I I I I I I I I I III I I I I I I I i_ 



/MyjiLOGY, 



DD 



.DSNAMTE = SYS,l.SYS;VL0GY,W0LU;ME = (rRETAi;NiSER=AAAi;i2)? 

I I I I I I I I I I I I I I I I I I I I I 1 .1 I I I I I I I I ■ • ■ • I ■ ■ • ■ I ■ ■ ■ ■ I ■ ■ ■ ■ 



// 



,UNIT=;2311rSPACE;=(120,5(100;) ) ?C0,NTI6)> 

I I I I I I I I I I Lj I I ' I I I I I I ' ' ' I I I I ' ' I ' I I'll 



,DISP=,C7KEE,P)7LA,BEL = E,XPDT=,99350, 



I I I I l_J L. 



I I I I I I 

DATA SETS- , 

J_j I I I I I I I lJ_ 



//SYSIN 

I I I, I I 



DD 



-INPUT FOR ,CATAL06ING, SYST.EM 

_I_J I I I I I I I I I I, I I iH L_l I I I I I I, ,1 



,CATLG 



CV,OL=23,01 = AA,AlllrVOL = 2301 = AAAill,»DSNAME=SY,Sl.PR,OCLIB, 



J I I I I I 



iCATL.G, 



CV,OL=230,l=AA,AlllrVOL = 2301 = A,AAlll,)DSNA,ME=SYSl.SO,RTLIB, 



,CATLG 



CVpL 

I I I I 



2301 =AA,AlllvVOL = 2,301 =AAA1 11, )DSNAME=SY,S1 



COIBLIB 

I I I I 



,CATLG 



CV,OL=23,01=AA,AlIlvVOL=2,301--A,AAlll,^DSNA,ME»SY,Sl.FO,RTLIB, 

I I I I I I I I I I Lj L_i 1 i_i I I Li i i i I i_j i__] Li i i_i i i i__i L_i i__i i_J i i_i i I 



iCATLG, 

I II I ■ 



CV,OL = 23,01 = AA,AlilvVOL = 2,301=A,AAlll,iDSNA,ME = SY,Sl.PL,lLIB 



,CATLG 



cypi 



= 23,01 = AA,Alll7yOL = 2,301=AAAl 11, )DSNA,IY1E = SY,S1 

■■'■'■'' I I I I I i I I I I I I I a. 



AL6LIB 



CATLG 



CV|OL=23,01 = AAAlllvVOL = 2301 = A,AAlll,iDSNA,ME = 

!•-, , , . I I I I I I I I I I r I I I I I I I I I I I I I I 



_i I I I 



,CATLG 



SYSl . 

I I i.-L 



TE,LCMLI,B 



CV,OL = 23,01 = AA,AlllvVOL = 2,301= AAA 111,)DSNA,ME = SY,S1.SV,CLIB 



,CATL6 



CV,OL = 23,01 = AA,AllliyOL = 2,311 = A,AA112,iDSNA,ME 



_i I I I 



=SY,S1 

I I I I I 



LLNKLIB, 



,CATL6 



CV,OL = 23,01 



AAAlllrVOL 

J III I 



2,31 1'AAAll 2,7 DSNA,ME=SYS1.MA|CLIB 

_i_l I I I I I I I LJ I I I I I Lj I I I I I I I I 



,CATLG, 



CV,OL=23,01 = AA,AlllvVOL=2,311=A,AA112,)DSNA,ME = 



SYSl 

I I I I L 



SY,SVLOG,X 



CATLG 



I I I I I I I 



CV,OL = 23,01 = AA,AlllrVOL=2,311 = 

■ I I I I — I I I I I I I I I I I I I I I I I I 



AAAl 12,iDSNAME»SY,Sl . SY,SVLOG,Y 

I I I, I I I I I I I I I I I 1 



I t I I 



/* 



I I I I I I I 



I I I I I I I 



-i_j I I I I I I I I I 



I I I I I I I I I 



Figure 5. 



Initializing 
(Part 2 of 2) 



the Systein Data Sets — Two Volunies Residence 



• The use of the generating system data sets, new system data sets, 
and utility data sets during system generation. (The generating 
system data sets and utility data sets are described in the section 
" Syst em/3 6 Requirements . " ) 



The following rule 
the available volumes: 



may be used to allocate the system data sets on 



• During Stage I and the beginning (assembly steps) of Stage II of 
system generation, the volumes that contain the utility data sets 
for system generation, and the generating system data sets, except 
for SYSl.MODLIB, must be mounted at the same time. 

• After the assembly steps of Stage II, SYSl.GENLIB and two of the 
utility data sets (those that need not reside on direct-access 
volumes) are no longer needed and may be removed. SYSl.MACLIB of 
the generating system may also be removed at this point if the 
MACLIB macro- instruction is not used during system generation. (See 
the description of the MACLIB macro- instruction in the section 
"Specifying the System.") 

• The volumes that contain SYSl.MODLIB, the new system data sets, and 
the volumes that contain user-written modules to be added to the new 
system must be mounted after the Stage II assemblies. 

If there are enough drives available, all generating system data 
sets, new system data sets, and system generation utility data sets 
should be mounted at the same time. If there are not enough drives, the 
volumes that contain data sets not required for a given step must be 
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dismounted and the volumes that contain the data sets required for that 
step must be mounted. The scheduler indicates to the operator which 
volume should be mounted. 

The new system data sets can be arranged in different ways on one or 
more volumes. For best performance, it is desirable to place the system 
data sets on more than one volume. Whenever possible, frequently used 
data sets should be located on a volume other than the system residence 
volume. System data sets on the same volume should be arranged 
according to the interaction between them: the more interaction, the 
closer they should be placed. For example, for best performance 
SYSl.LINKLIB Should be placed on a volume other than the system 
residence volume. However, if it must be on the system residence 
volume, it should be adjacent to SYSl.SVCLIB because SYSl.LINKLIB and 
SYSl.SVCLIB are frequently used data sets and are closely related. In 
this same example, space for SYSl. NUCLEUS should be allocated last, 
because this data set is referred to only by the IPL program. (Data 
sets are allocated in the order in which they are defined by DD 
statements in the input deck.) 

If there are not enough drives available to achieve the desired 
distribution of new system data sets, the lEHMOVE utility program can be 
used to distribute the data sets after system generation. If SYSl. 
SVCLIB is changed, replaced, or moved after system generation, the 
lEHIOSUP utility program must be executed. If the MACLIB macro 
instruction was not used during system generation, the lEBCOPY utility 
program can be used to copy SYSl. MACLIB from the generating system to 
the new system. 

The following pages contain examples of allocation on configurations 
with two, three, four, and five direct-access devices. In all these 
examples, the four utility data sets required for system generation are 
called SYSl.UTl, SYS1.UT2, SYS1.UT3, and SYSl.OBJMOD. SYSl.UTl and 
SYS1.UT2 may reside on magnetic tape. 
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Generation on Two Drives 

Figure 6 shows the distribution of data sets using two 2311 Disk 
Storage Drives and three volumes. The generating system data sets 
reside on volumes #1 and #2. All new system data sets reside on volume 
#3. SYSl.UTl and SYS1.UT2 reside on magnetic tape. The scheduler, when 
required, automatically requests the dismounting of volume #2 and the 
mounting of volume #3 on drive #2. The generating system is a 
customized version (see Appendix E) of the starter operating system. 




DRIVE *1 
VOLUME ^"1 



■SV gCTLG 
jV Sl. PROCU g, 
^SV Sl. SORTU g- 
~§V 31. COBL(g ^ 
■jV Sl UUCLB US. 
-^>: S1. LQGRj C^ 
jV gl. MOPtjg ^ 
JV S1.UT3 _ 
.SV^IOBJMOP. 



DRIVE <^e 

VOLUME '^'E 
SYS1. MACLie 





jY Sl. LIN KLJg. 

JV SCTLG 

jY Sl. PROCjJ g 
jY Sl. SORTU g 
SySlXOBUB_ 
jV ^l HUCLB US, 
SVS1. L06RB0 



Figure 6. Generation on Two Drives 
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Generation on Three Drives 

Figure 7 shows the distribution of data sets using three 2311 Disk 
Storage Drives and four volumes. The generating system data sets reside 
on volumes #1, #2, and 3- All new system data sets reside on volume 
#4. The scheduler, when required, requests the dismounting of volume #2 
and the mounting of volume #4 on drive #2. Note that volume #2 contains 
all the generating system and utility data sets that are no longer 
needed after the Stage II assemblies. 




DRIVE *1 
VOLUME *1 



jV ^1. LINK LIA 

jV SCTLG 

JY SI. PROCL lg, 
>jj ^1. SORTU g, 
^SY SI. COBLI g ^ 
jj gl. FORTU g, 

■j> g1. NUCLgy S 
- ^1. LQ6RI 5- 



DRIVE *2 

VOLUME^E 

JYSI.GENui 
j YSI.MACU g. 

sysujtz. 

SYS1. UT1 



PRIVETS 

VOLUME^S 

jvgl. MOPuk 
SYS1.0BJM0D. 



jY Sl. LINKLIg , 

jV SCTLG 

JV SI. PROCU g: 
jVS I. SORTU g. 
JYS I. FORTL Ig, 

JV 3l. LOeRB C, 



Figure 7. Generation on Three Drives 
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Generation on Four Drives 

Figure 8 shows the distribution of data sets using four 2311 Disk 
Storage Drives and four volumes. All new system data sets reside on 
volume #4. No dismounting and mounting of volumes is required during 
this generation. 




DRIVE ^1 

VOLUME *1 



jV Sl. SVCLIB^ 

JV SCTLG 

JV $1. PROCU g, 

-^YStCOBUB^ 
jV Sl. FORTUg , 
-S( Sl. PL1LIB_ 
JY Sj. NUCLgU g- 

^YSl. UT3 



DRIVE »2 
VOLUME ^2 

lYSI.MACL jB. 
SYS1. UT2 



D RIVE ^3 

VOLUME *3 

J YSI. MOP Ug. 
SYS1. UT1 



DRIVE ^^4 




gV Sl. SYSJOg g^ 
■^Y SI. SVCLIg ,,^ 

JY SCTL6 - 

>§V S1. PROCU g^ 
-§V S^I. SORTUg ^ 
•j ^1. COBLIg , 
•jj g_1. FORTU g^ 
JV gj. PL1Llg .„^ 
■^YSjLTELCMtiS- 
>gY Sl. NUCLE US^ 

JY S_1- LOGREC ^ 
-§YS1. OBJMOP^ 



VOLUME ^'S 
SYS1.ALGLI5 



Figure 8. Generation on Four Drives 
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Generation on Four Drives With Two Volumes for New System 

Figure 9 shows the distribution of data sets using four 2311 Disk 
Storage Drives and five volumes. The generated SYSl.LINKLIB and 
SYSl.ALGLIB are to £>e placed on the volume marked #5. All other new 
system data sets are to be placed in volume #4. The scheduler, when 
required, requests the dismounting of volume #2 and the mounting of 
volume #5 on drive #2. 



DRIVE ^'l 




SV gl.SYSJOg gE- 
^YSI. SVCU& 



JX gCTLG 
■g ^. PROCU g, 
-SYSl^soRTUl, 
■ ^I.COBUB . 

-^V Sl. PLILIB , 
-§:! g.1. NUCLE US- 




DRIVE ^2 

VOLUME ^2 




j YSI. MACL lB 
SYS1. UT2 




DRIVE ^4 




jV $1 . SYSJO gg§^ 

JV S1.SVCLIB , 

-jV SI.LINK Ljg. 

^Sy gCTLG _ 

JV Sl.PROCL lg- 

-Sy Sl.SORTU g. 

-SYSrcOBUg^ 

jY Sl.FORTiJ g. 

jj gl.MACLig . 
-.§YSij^yCLEyS 

.Sysi.OBJMOg, 



Figure 9. Generation on Four Drives With Multiple Volumes 
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Generation on Five Drives With Two Voliimes for New System 

Figure 10 shows the distribution of data sets using four 2311 Disk 
Storage Drives, one 2301 drum storage drive, and five volumes. Volume 
#5 is the new system residence volume. SYSl.MACLIB resides on volume 
#5. All other new system data sets not required to be on the system 
residence volume are located on volume #4. 



DRIVE *1 




-SVSLSYSJOBQg 



-gV Sl. SVCLlg , 

JV ^TLG ^ 

-gV Sj. SORTLI B, 
"-SYSi^jCOBUB, 
jy St. FORTUg 

>JV S1. PL1Llg ■ 

-^JI^ SI. NUCLEU g, 



PR!V6»2 

VOLUME *2 

! ^S1. GENLl £ 
-S YSI. MAClJ g. 
.SYS1. UT2 



DRIVE ^3 

VOLUME *3 

■J ysi. mop lib. 

^YSI. UT1 



DRIVE *^4 




jV ^I. SYSJOB Og. 

■SY St. TELCML lg. 

>gY S1. LINKLI P^ 

•^Y SI. PROCjJ g. 

>§YSl_S0Rlkl5- 
JV St. COBLIB . 
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jY Sl. PLILIg ^^ 
•JV SI. SYSVt Og^ 
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DRIVERS 

VOLUME '^S 
(2301) 
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Figure 10. Generation on Four Drives With Multiple Volumes 
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Generation on Four 2314 Drives 

Figure 11 shows the distribution of data sets using four 2314 
Direct- Access modules. All generating system data sets reside on volume 
#1. Volume #2 is the new system residence volume. The new SYSl. 
LINKLIB, SYSl.MACLIB, and SYSl.ALGLIB are to be placed on volume #3. 



DRIVE^I 



VOLUME -^^l ^ 
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Figure 11. Generation on Four 2314 Volumes 
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SPECIFYING THE SYSTEM 



The system to be generated is specified by the user. Specifications 
are of two types: job control language statements and system generation 
macro- instructions. The job control language statements are those 
required to perform an assembly. The system generation macro- 
instructions describe the machine configuration of the installation, 
those options the user desires, and the type of generation to be 
performed. The programs and routines generated as a result of these 
specifications are placed into the appropriate operating system 
libraries during the system generation process. 

The following sections describe the input deck required for system 
generation, and the conventions used to code system generation macro- 
instructions. A detailed description of each system generation macro- 
instruction and a table showing their relationship to each type of 
system generation are also included. 

From the specifications supplied to the system generation macro- 
instructions, parameters are created for the job control language 
statements produced from Stage I and included in the job stream to Stage 
II. Samples of these statements are shown in the section "Restart 
Procedures. " 

Note ; The specifications for a system generation must be compatible 
with the cataloging and space allocation performed during the 
preparation for that generation. 

INPUT DECK FOR SYSTEM GENERATION 

The input deck required for Stage I of system generation consists of 
job control language statements and system generation macro- 
instructions. The sequence of the deck and the job control language 
statements are shown in Figure 12. This figure represents a three- 
drive system generation. For other generations, only the underlined 
values need vary. (In Figure 12, the generating system resides on a 
volume whose serial number is DLIBOl; SYSl.MACLIB and SYSl.GENLIB reside 
on a volume whose serial number is DLIB02; SYSl.MODLIB resides on a 
volume whose serial number is DLIB03; and unit 182 is a 9-track magnetic 
tape.) It is recommended that the values given to the UNIT keywords of 
the DD statements be generic unit names. (See Appendix C.) 

The first statement of the deck is an EXEC statement indicating that 
the generation process immediately follows the catalog building step 
described in the previous section. Alternatively, system generation can 
be defined as an independent job. 

The four DD statements named OBJPDS, SYSUTl, SYSUT2, and SYSUT3, 
respectively, are used to allocate space to the four utility data sets 
required for the system generation process. These data sets are 
cataloged as SYSl.name in the generating system, where the value of name 
cannot exceed eight alphameric characters, the first of which must be 
alphabetic. These names (SYSl.name) must also be specified as the value 
of the corresponding keywords (OBJPDS, UTISDS, UT2SDS, and UT3SDS) in 
the GENERATE macro-instruction. The data set defined by the OBJPDS DD 
statement must be a partitioned data set. The other three data sets 
must be sequential data sets, of which the one specified by the SYSUT3 
DD statement must reside on a direct-access volume. Table 2 shows the 
values to be given to the SPACE keyword of each of the DD statements for 
the utility data sets according to the type of direct-access device on 
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which they may reside. To determine if there is enough space available 
in the direct-access volume, list its volume table of contents (VTOC) 
before Stage I using the lEHLIST utility program. 



r - 

1 //STEPl 


EXEC PGM=ASMBLR -STAGE I INPUT DECK- 




I//SYSLIB 


DD 


DSNAME=SYS1 . GENLIB , DISP=OLD 




j //OBJPDS 


DD 


DSNAME=SYSl.OBJMOD,VOLUME={ , RETAIN, SER=DLIB01) , 


X 


|// 




DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (40,20,8)) 




1 //SYSUTl 


DD 


DSNAME=SYS1. UT1,V0LUME=( , RETAIN, SER=DLIB01) , 


X 


|// 




DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (240,20)) 




1 //SYSUT2 


DD 


DSNA^lE=SYSl . UT2 , VOLUME= ( , RETAIN , SER=DLIB0 2 ) , 


X 


|// 




DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (240,20)) 




I//SYSUT3 


DD 


DSNAME=SYS1. UT3, VOLUME= ( , RETAIN, SER=DLIBO 3) , 


X 


|// 




DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (300,20)) 




1 //DUMMY 


DD 


VOLUME=(, RETAIN, REF=*.SYSUT 3) ,SPACE=(TRK, (80)) 




1 //SYSPUNCH 


DD 


UNIT=182 , LABEL= ( ,NL) 




I//SYSPRINT 


DD 


SYSOUT=A 




1 //SYSIN 


DD 
1 \ 


* 






» System generation macro-instructions 




1 I 


:nd 






[/* 








|// START RDR,182 (Optional statement; see text) 

L 


J 


r 

1 Note : Unc 


ierlined values represent variables. All other values 
J shown. The continuation characters are in column 72. 


must 


1 be coded as 





Figure 12. Input Deck Organization for System Generation 



If magnetic tape drives are available, 
SYSUTl and SYSUT2 DD statements can be 
tape. If only one utility data set is 
one specified by the SYSUTl DD statement 
sets defined by the SYSUTl or SYSUT2 DD 
magnetic tape, LABEIj=(,NL) must be specif 
statement, and NL must also be specified 
of the GENERATE macro-instruction. 



the data sets specified by the 
assigned to 9-track magnetic 
to reside on magnetic tape, the 
should be chosen. If the data 

statements reside on unlabeled 
led in the corresponding DD 
in the DTlSDS or UT2SDS keyword 



The DD statement named DUMMY is used to reserve space on the volume 
that contains the utility data set defined by the SYSUT3 DD statement 
for the lEHMOVE utility program. lEHMOVE allocates its own space on 
that volume during Stage II of system generation. The DUMMY DD 
statement is optional, but it should be used to ensure that the required 
number of tracks will be available during Stage II. (The data set 
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created by the DUMMY DD statement is deleted at the end of Stage I.) 
The value to be given to the SPACE keyword of the DUMMY DD statement is 
determined by the type of device on which the data set specified by the 
SYSUT3 DD statement resides. The appropriate values are shown in 
Table 2. 



Table 



Space Allocation for Utility Data Sets 



DD Statement 



Device j-- 
Type I 



OBJPDS 



T T T- 

I SYSUTl I SYSUT2 | 
.+ -I- +. 



SYSUT3 



+- 

2311 I (40,20,8) I (240,20) | (240,20) | (300,20) j 

2301 j (10,2,8) I (45,4) | (45,4) | (60,4) 



DUMMY 
(80) 
(14) 






2303 


1 


+- 

(40,8,8) 1 


(180,16) 


1 


(180,16) 


-+- 

1 


(240,16) 


1 


(80) 


2314 


1 


+- 

(32,10,8) 1 


(160,10) 


-+- 
1 


(160,10) 


-+- 
1 


(200,10) 


1 


(60) 




- ± 


-L- 




1 




_.i_ 




_x _ 





The DD statement named SYSPUNCH defines the data set that is to 
contain the job stream produced during Stage I of system generation. If 
any error messages (see Appendix A) occur during system generation, the 
job stream is not produced. After a successful completion of Stage I, 
the job stream produced becomes the input to Stage II. (The stage I 
output should be saved after system generation for maintenance pur- 
poses.) If the device defined by the SYSPUNCH DD statement is a card 
punch, the operator is required to place the cards in an input device 
and to issue a START RDR command for that device. However, operator 
intervention can be eliminated by making the output (SYSPUNCH) of Stage 
I become the input reader to Stage II . If the value given to UNIT in 
the SYSPUNCH DD statement is the specific unit name of a magnetic tape 
drive, this can be accomplished by inserting a // START RDR,xxx 
statement after the /* card of the input deck (see Figure 12). xxx is 
the specific unit name given to UNIT in the SYSPUNCH DD statement. If 
there were any errors during Stage I, there will be an end-of-file 
condition detected and the reader will be closed. The section "Operat- 
ing Considerations" indicates some of the conditions that require 
operator intervention, and shows sample console listings from system 
generation processes. 

Note: The input deck described is the input to Stage I of the system 
generation process. During Stage I a job stream is produced which 
serves as the input for Stage II. After a satisfactory completion of 
Stage I, the beginning of Stage II is a logical restart point. If any 
errors are made that require restarting from the beginning of Stage I, 
the data sets specified by the OBJPDS, SYSUTl, SYSUT2, and SYSUT3 DD 
statements must be scratched and uncataloged before restarting. For 
more information refer to the section "Restart Procedures." 



CONVENTIONS 

This section describes the conventions used to code system generation 
macro-instructions and the notation used in this publication to describe 
system generation macro-instructions. 

CODING MACRO- INSTRUCTIONS 

The rules for coding system generation macro-instructions are those 
of the assembler language. The following paragraphs are a summary of 
these rules as stated in the publication IBM System/360 Operating 
Systemit Assembler Language . 
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Systera generation macro- instructions have the following standard 
format: 

r T T 1 

I Name | Operation | Operand | 

|. 1 ^ ^ 

I Symbolic | Macro- | Optional and required parameters | 

J name | instruction j | 

I I type I I 

L JL X J 

The name symbolically identifies the macro-instruction. If included, 
it can contain from one through eight alphameric characters, the first 
of which must be alphabetic. The name must begin in the first position 
of the macro- instruction and must be followed by one or more blanks. 
Unless otherwise indicated in the description of individual macro- 
instructions, the name field of a system generation macro-instruction is 
ignored during system generation. 

The operation identifies the macro- instruction. It must be preceded 
and followed by one or more blanks. 

The operand contains parameters coded in any order and separated by 
commas. The operand field ends with one or more blanks placed after the 
last parameter. In most system generation macro-instructions, keyword 
parameters are used in the operand field- A keyword parameter consists 
of a keyword followed by an equal sign (=) and the keyword value. The 
keyword value must be a single value or a list of values; in the latter 
case, the values must be separated by commas and the list enclosed in 
parentheses. 

Comntents can be written in a system generation macro- instruction, but 
they must be separated from the last parameter of the operand field by 
one or more blanks. An entire card may be used for a comment by placing 
an asterisk in the first column. Extensive comments may be written by 
using a series of cards with an asterisk in the first column of each 
card. A macro- instruction that has no parameters can not have comments. 

A typical system generation macro- instruction might appear as: 

r 1 

I NAME OPERATION KEYl=value , KEYU= { value^. , valuea ) , KEY3=value , . . . | 

L J 

System generation macro- instructions are coded in columns 1 through 
71 of a card. A macro-instruction that exceeds column 71 can be 
continued onto one or more additional cards; a nonblank character is 
placed in column 72 to indicate continuation. The macro- instruction can 
be interrupted either in column 71 or after any comma that separates 
parameters. The continued portion must begin in column 16 of the 
following card. Comments can be coded through column 71, and, if 
continued, must begin in column 16 of the following card. In addition, 
comments may appear on every card of a continued statement. Columns 73 
through 80 can be used to code identification and/or statement sequence 
characters. 

DESCRIBING MACRO- INSTRUCTIONS 

The following conventions are used in this publication to illustrate 
the format and coding of system generation macro-instructions: 

• Upper case letters , numbers , and punctuation marks must be coded by 
the programm.er exactly as shown. Exceptions to this convention are 
brackets, [ ]; braces, { }; ellipses, ...; and subscripts. These 
are never coded. 
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• Lower case letters and words represent variables for which the 
programmer must substitute specific information or specific values. 

• Items or groups of items within brackets, [ ] , are optional. They 
may be omitted at the programmer's discretion. Conversely, the lack 
of brackets indicates that an item or group of items roust be coded. 

• Braces, { }, group related items. 

• Stacked items, enclosed in either brackets or braces, represent 
alternative items. Only one of the stacked items should be coded. 

• If an alternative item is underlined, that item is implied; that is, 
the operating system will automatically assume it is the program- 
mer's choice when none of the items are coded. 

• An ellipsis (...) indicates that the preceding item or group of 
items can be coded more than once in succession. 



SYSTEM GENERATION MACRO- INSTRUCTIONS 

The content of the new operating system is specified through system 
generation macro-instructions. Not all system generation macro- 
instructions are required for the system generation process. Table 3 
lists the system generation macro-instructions for each type of system 
generation, indicating whether they are required or optional. If 
neither required nor optional is indicated, that macro-instruction does 
not apply to that type of system generation. 

The type of system generation must be specified in the GENERATE 
macro- instruction. Table 3 also shows which macro-instructions can be 
issued more than once during a system generation process. All UNITNAME 
macro- instructions having the same NAME value must appear together in 
the input deck. Each lOCONTRL macro-instruction must precede in the 
input deck to system generation those lODEVICE macro- instructions that 
define devices attached to that control unit. All other system 
generation macro-instructions, with the exception of GENERATE, can be 
issued in any order. The GENERATE macro-instruction must be the last 
macro- instruction in the input deck for the system generation process. 

Dependencies between the parameters of a macro- instruction are 
illustrated by the macro- instruction format and, when necessary, by 
tables within each macro-instruction description. Dependencies between 
macro-instructions are stated in the descriptions of each macro- 
instruction and summarized in Appendix B. Appendix B also lists the 
references made in the macro- instruction to other publications. 

Several keywords in the system macro-instructions request the speci- 
fication of the unit name of a device . For example, UNIT=name in the 
FORTLIB macro- instruction and RESNAME=name in the GENERATE macro- 
instruction. The unit name of a device can be one of the following: 

• specific unit name, or address, such as 192. 

• generic unit name, such as 2311. (Generic unit names are listed in 
Appendix C . ) 

• user-specified unit name, or name of a collection of devices, such 
as TAPE or SYSDA. 

It is recommended that generic unit names be used, although all three 
types are equally valid. 

Primary data management routines and system utilities are included in 
every operating system generated; therefore, their inclusion is not 
specified in any of the system generation macro-instructions. 
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Note : The region size for a processing prograiri operating under MVT must 
be greater than the value given to the SIZE parameter of the macro- 
instruction that specifies that processing program. For further infor- 
mation refer to the Programii«er*s Guide associated with the processing 
program. Region sizes are given in the publication IBM System/360 
Operating System: Storage Estimates . 



Table 3. System Generation Macro- Instructions 

r T 

Type of System Generation^ 



Macro- Instruction 



Operating System j Nucleus j Processor/Library 



-+- 



-+- 



CENPROCS 

CHANNEL^ 

I0C0NTRL2 

I0DEVICE2 

UNITNAME2 

CTRLPROG 

SCHEDULR 

SUPRVSOR 

SVCTABLE2 

RESMODS 

SVCLIB 

PROCLIB 

LINKLIB 

DATAMGT 

TELCMLIB 

GRAPHICS 

SYSUTILS 

EDIT0R2 

ASSEMBLR2 

TESTRAN 

MACLIB 

CHKPOINT 

SORTMERG 

SORTLIB 

ALGOL 

ALGLIB 

COBOL2 

C0BLIB2 

FORTRAN^ 

FORTLIB 

PLl 

PLILIB 

RPG 

GENERATE 



Required 
Required 
Required 
Required 
Optional 
Required 
Required 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Required 



Required 
Required 
Required 
Required 

Required 
Required 
Optional 
Optional 
Optional 



Optional 
Optional 



Optional 
Optional 



Required 



Required 



Optional 3 



Optional 
Optional 
Optional 



Optional 
Optional 



Optional 



Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Optional 
Required 



^The type of system generation is specified with the GENTYPE 
parameter of the GENERATE macro-instruction. GENTYPE=ALL specifies 
the generation of an operating system. GENTYPE=NUCLEUS specifies 
the generation of a nucleus to be included in the operating system. 
(No libraries, except SYSl. NUCLEUS, are affected by this type of 
system generation. ) GENTYPE=PROCESSOR specifies the generation of 
processors and/or their associated libraries to be added to the 
operating system. 

^This macro-instruction can be issued more than once during a system 
generation process. 

^This macro- instruction is used during a processor/library genera- 
tion if, and only if, the PLl macro- instruction is used. 
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CENPRQCS 

The CENPROCS macro- instruct! on is used to describe the central 
processing unit. This macro-instruction is required. 



Name 



Operation 



i Operand 

'30' 

UOI 

KODEL=(50 

651 

75 

STORAGE= g( 

Hj 

I 

J 

STD 
INSTSET= COMM 

SCNTF 

UNIV 
tFEATURE= (feature [ , feature] ) ] 



CENPROCS 



Operand Field ; 

MODEL=model 

specifies the model of the central processing unit. 

STORAGE 

specifies the size of main storage as one of the following: 

Value Storage Size (in bytes ) 



32K 

128K 

256K 

512K 

102UK 



Note: The MODEL and STORAGE parameters are used for diagnostic purposes 
only. Therefore, an operating system generated for a CPU could operate 
on another one. 



INSTSET 

specifies the instruction set available in the central processing 
unit as one of the following: 



Value 



Instruction Set 



STD Standard 

COMM Commercial (Standard instruction set with decimal 

feature) 
SCNTF Scientific (Standard instruction set with floating point 

feature) 
UNIV Universal (Standard instruction set with decimal, 

floating point and storage protection features) 

Note ; This parameter need not be specified for model 50 or above; UNIV 
is always assigned in this case. 
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FEATURE=featuren 

specifies the optional features installed in the central processing 
unit as one or more of the following values. These values can be 
written in any order. 

Value Feature 

TIMER Interval tiiDer on model 30 
PROTECT Storage protection 

Example : In the following example, a CENPROCS macro-instruction is used 
to describe a model 40 central processing unit with a main storage size 
of 64K bytes. The commercial instruction set is used. 



r T 

I CENPROCS MODEL=40,STORAGE=F,INSTSET=COMM | 

L . J 
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CHANNEL 

The CHANNEL macro-instruction is used to describe channel character- 
istics. A CHANNEL macro-instruction is required for each channel of an 
installation's computing system. 



I Name | Operation | Operand 

|. ^ ^ 

I [name] j CHANNEL j ADDRESS=address 

I i I (SELECTOR j 

I I I TYPE= j MULTIPLEXOR 

I I j (HISPEEDMULTIPLEXOR) 



Name Field: 



name 



is used in system generation error messages (see Appendix A) to 
identify the CHANNEL macro-instruction that produced an error. If 
no name is entered, the macro-instruction supplies sequential 
identification numbers to the CHANNEL macro-instructions in the 
same order in which these macro-instructions are introduced in the 
user's input stream. These numbers are used for identification 
purposes instead of names. For example, if the name is omitted 
from the third CHANNEL macro-instruction in the input stream, the 
name CHAN#3 is supplied in each diagnostic message resulting from 
an error encountered in the macro-instruction. 



Operand Field : 

ADDRESS=address 

specifies the address of the channel as one of the following: 0, 
1, 2, 3, 4, 5, or 6. 

TYPE 

specifies the type of channel as one of the following: 

Value Channel 

SELECTOR Selector 

MULTIPLEXOR Multiplexor 
HISPEEDMULTIPLEXOR 2870 Multiplexor 

Note ; If a 2870 multiplexor channel is specified, no burst devices 
should be attached to the multiplexor portion of the channel. 

Example : The following example illustrates the use of the CHANNEL 
macro- instruction to describe a multiplexor channel whose address is 0. 



|MPX CHANNEL ADDRESS=0 ,TYPE=MULTIPLEXOR 

L 
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lOCONTRL 

The lOCONTRL macro-instruction is used to describe a control unit and 
its operating system requirements. An lOCONTRL macro-instruction is 
required for each control unit (listed in Table 4) in the user's 
computing system. A maximum of 40 lOCONTRL macro-instructions may be 
issued during a system generation. If more are required see Appendix D 
for the procedure to be followed. For assistance in choosing valid 
combinations of values for the UNIT, MODEL, and FEATURE keywords, refer 
to Table 4. 



■T T 

I Operation | Operand 



j Name 




UNIT=unit 
ADDRESS=address 

[iyiODEL=model] 

[FEATURE= (feature [, feature] 

For UNIT=2821 Only: 
TRNMODE= j BYTE \ 

I burst) 

For UNIT=28U0 Only ; 
[EXPBFR=number] 



...)] 



Name Field: 



name 



is used in system generation error messages (see Appendix A) to 
identify the lOCONTRL macro-instruction that produced an error. If 
no name is entered, the macro- instruction supplies sequential 
identification numbers to the lOCONTRL macro-instructions in the 
same order in which these macro-instructions are introduced in the 
user's input stream. These numbers are used for identification 
purposes instead of names. For example, if the name is omitted 
from the sixth lOCONTRL macro-instruction in the input stream, the 
name UNIT#6 is supplied in each diagnostic message resulting from 
an error encountered in the macro-instruction. 

Operand Field : 

UNIT=unit 

specifies the control unit number as one of the following: 1051, 
2403, 2404, 2415, 2701, 2702, 2703, 2803, 2804, 2820, 2821, 2822, 
2840, 2841, or 2848. 

Notes : • The IBM 1052 printer-keyboard is attached to model 40 or above 
through an IBM 1052 adapter, and not through a control unit- 
Thus, an lOCONTRL macro-instruction is not needed in this 
case. 



2816 is implied through the specification of the OPTCHAN 
parameter in the lODEVICE macro- instruction, and need not be 
specified in any macro-instruction. 



• If a 2260 is attached to a 2701 through a 2848; 
implied and must not be specified. 



the 2848 is 



ADDRESS=address 

specifies the address of the control unit. The address value 
consists of two hexadecimal digits whose valid range of values is 
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00 to 6F. This value normally corresponds to the two high order 
digits of the addresses of the devices attached to the control 
unit. If the high order digits of the device addresses differ, the 
lowest value must be used. For example, if the addresses of the 
devices attached to the control unit are OOE and 010, the value 
given to the ADDRESS keyword of the lOCONTRL macro-instruction must 
be 00. 

Note ; There must be only one lOCONTRL macro- instruction for each 
control unit. The value given to address must be the lowest address of 
the control unit. The other addresses must not be specified. 

MODEL=model 

specifies the model, if any, of the control unit as one of the 
following: 1, 2, 3, 4, 5, 6, 21, 22, or N1 . 

FEATURE=f ea turen 

specifies the optional features that are present on the control 
unit as one of the following values. These values can be written 
in any order. Features enclosed in braces { } are mutually 
exclusive. 

Value Feature 

ABSLTVEC Absolute vector control on 28U0, model 1 

|ADSTORAGl Additional storage on 284 1 

I 2-CHANSwt 2-channel switch on 28U1 

BUFFER8K Additional 8K buffer on 2840, model 1 

COLBNRY Column binary on 2821, model 1, 4, or 5 

DATACONV Data conversion on 2403, 2404, 2803, or 2804 

LINEADDR Line addressing on 2 848 

NODESCUR Non-destructive cursor on 2848 

RECOFLO Record overflow on 2841 

7-TRACK 7-track compatibility on 2403, 2404, 2803, or 2804 

16-DRIVE 16-drive addressing on 2403 or 2 803 

800BPI 800 BPI on model 4, 5, or 6 of 2403 or 2415, or on model 
2 of 2803 or 2804 

TRNMODE 

specifies the data transmission mode for an IBM 2821 Control Unit 
attached to a multiplexor channel. The value selected, either BYTE 
or BURST, must correspond to the setting of the mode switch on the 
2821 CE panel. This parameter must be specified if, and only if, 
the value of UNIT is 2821. 

EXPBFR=number 

specifies that programs written for a 2250, model 1, not using the 
DCB operand GTYPE=BASIC can be used with a 2250, models 2 or 3, 
attached to a 2840. The value specified is the amount of buffer 
space, in bytes, required by the programs- The value must be an 
integer of from 1 to 8192. If this parameter is omitted, a value 
of 4 096 is assumed. 

Example : The following example illustrates the use of the lOCONTRL 
macro- instruction to describe an IBM 2821 control unit, model 4, with 
the column binary feature. The control unit operates in the byte mode, 
and its address is 05. 



r 1 

I lOCONTRL UNIT=2821,MODEL=4,ADDRESS=05,FEATURE=COLBNRY,TRNMODE=BYTE | 

L - J 
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Table 4. Keyword Values for lOCONTRL Macro- Instruction 
(Part 1 of 2) 



UNIT 
1051 



MODEL 
1 or N1 



FEATURE 



+- 



2403 



1 , 2 , or 3 



4, 5, or 6 



DATACONV 
7-TRACK 
1 6-DRIVE 



DATACONV 
7-TRACK 
1 6-DRIVE 
800BPI 



2404 



1, 2, or 3 



DATACONV 
7-TRACK 



2415 



1, 2, or 3 



4, 5, or 6 



DATACONV 
7-TRACK 



DATACONV 

7-TRACK 

800BPI 



2701 
2702 



\- 



2703 



-+ 



2803 



\- 



DATACONV 
7-TRACK 
1 6-DRIVE 



DATACONV 
7-TRACK 
1 6-DRIVE 
800BPI 



2804 



-+ 



DATACONV 
7-TRACK 



DATACONV 

7-TRACK 

800BPI 



2820 
2821 
2822 



1 , 4 , or 5 

2, or 3 



COLBNRY 



J 

(Continued) 
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Table 4. Keyword Values for lOCONTRL Macro-Instruction 
(Part 2 of 2) 

r T T 1 

I UNIT I MODEL | FEATURE | 

|. 1 -(. _ . 

I 1 I BUFFER8K 

2 840 I I ABSLTVEC 

|. + 

I 2 I 
1^ 1 + 

2 8U1 I I ADSTORAG or 2-CHANSW 
I I RECOFLO 
|. 1 + 

2848^ I 1, 2, 3, 21, or 22 j LINEADDR 
I I NODESCUR 
|. J. ± . 

j^A 2260, model 1, cannot be attached to a 2848 model 1, 2, 21, or 22. | 

L - J 
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I ODE VICE 



The lODEVICE macro- instruction is used to describe the characteris- 
tics of an input/output device and its operating system requirements. 
An lODEVICE macro-instruction is required for each uniquely addressable 
input/output device in the system. A maximum of 96 lODEVICE macro- 
instructions may be issued during a system generation. If more are 
required see Appendix D for the procedure to be followed. In the input 
deck for system generation, each lOCONTRL macro-instruction must be 
immediately followed by the lODEVICE macro-instructions that define 
devices attached to that control unit. For assistance in choosing valid 
combinations of values for the UNIT, MODEL and FEATURE keywords, refer 
to Table 5. 

In the case of telecommunications devices, there must be one lODEVICE 
macro-instruction for each telecommunications line. That is, the 
lODEVICE macro- instruction applies to telecommunications lines, not to 
terminal devices. All terminals on a line must be of the same type with 
the same features. The type of terminal on the line is used to identify 
the line in the UNIT keyword. 

The value given to the ADDRESS keyword becomes the specific unit name 
of the device. Specific unit names are automatically assigned to the 
devices during system generation. Generic unit names are also provided 
in every operating system for each type of device specified by the UNIT 
parameter of an lODEVICE macro- instruct ion. Generic unit names are 
described in Appendix C. User-specified unit naunes can be assigned to a 
device, or to a collection of devices, with the UNITNAME 
macro-instruction . 



I Name 

h 

[name] 



i Operation 

"f 

lODEVICE 



I Operand 

4 

UNIT=junit \ 
\ DUMMY) 
ADDRESS=address 

[MODEL=model] 

[FEATURE= (feature [, feature] . . .) ] 

[ERRTAB=nnn] 

[DEVTYPE=type] 

For UNIT=2302, 2303, 2311,2314,2401,2402, 
2403 or 2404 Only; 

[OPTCHAN= (address [, address] - . .) ] 

For UNIT=1443 Only; 

|tRNMODE= j BURST (1 
[ (BYTE ij 

For UNIT=2250 (models 2 or 3) ,2280, or 2282 
Only; 

[NUMSECT=number] 

For Telecommunications Lines Only; 

ADAPTER=a dapt er 
[SETADDR=value] 

L J. i J 
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Name Field : 

name 

is used in system generation error messages (see Appendix A) to 
identify the lODEVICE macro-instruction that produced an error. If 
no name is entered, the macro- instruction supplies sequential 
identification numbers to the lODEVICE macro-instructions in the 
same order in which these macro-instructions are introduced in the 
user's input stream. These numbers are used for identification 
purposes instead of names. For example, if the name is omitted 
from the eleventh lODEVICE macro-instruction in the input stream, 
the name DEV#11 is supplied in each diagnostic message resulting 
from an error encountered in the macro-instruction. 

Operand Field : 

UNIT=unit 

specifies the unit number of the device as one of the following: 
1030, 1050, 1052, 1053, 1060, 1130, 1403, 1442, 1443, 2250, 2260, 
2280, 2282, 2301, 2302, 2303, 2311, 2314, 2321, 2401, 2402, 2403, 
2404, 2415, 2501, 2520, 2540R, 2540P, 2671, 2740, 115A, 83B3, S360, 
or TWX. (In the case of telecommunications lines, UNIT specifies 
the device type that is in the telecommunications line.) 

DUMMY specifies an unsupported device. A 32-byte UCB with all its 
standard fields is generated. It is assumed that the user provides 
his own I/O support routines for the device. Specific unit names 
are not generated for unsupported devices. If desired, they can be 
generated by the UNITNAME macro instruction. (See the examples 
following the description of the UNITNAME macro instruction.) 

Notes : • 2540R and 2540P refer to the same IBM 2540 card read punch, 
but, because they are uniquely addressable, the read (2540R) 
and punch (254 OP) functions must be specified as two different 
units in separate lODEVICE macro- instructions. 

• S360 refers to a remote System/360 attached to the channel 
through a 2701 or 2703 control unit. For the purposes of 
system generation, this remote System/360 is considered to be 
a telecommunications line, and must be defined as such with an 
lODEVICE macro instruction. 

• TWX refers to either the teletype model 33 or 35. 

ADDRESS=address 

specifies the address of the device or telecommunications line. 
The address value consists of three hexadecimal digits whose valid 
range of values is 000 to 6FF. The high order digit of the address 
value is the address of the channel (specified in the CHANNEL 
macro- instruction) to which the device is attached. For example, 
if the address of the device is 190, the address of the channel is 
1. 

Note: There must be only one lODEVICE macro-instruction for each 2314. 
The value given to ADDRESS must be the lowest address of the 2314. The 
remaining seven addresses are automatically generated. For example, if 
the addresses of the 2314 are 130 through 137, only ADDRESS=130 must be 
specified. Any other device that has more than one address, such as the 
2302, must be considered as a separate device for each address. For 
example, there must be two lODEVICE macro- instructions for each 2302 
that has two addresses. 

MODEL=model 

specifies the model number, if any, of the device as one of the 
following: 1, 2, 3, 4, 5, 6, 7, Bl, B2, B3, N1 , or N2. This 
parameter must be specified if the unit has a model number (see 
Table 5) . 
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Table 5, Keyword 
(Part 1 



Values for the lODEVICE Macro-Instruction 
of 3) 






UNIT 
1030 



MODEL 



FEATURE 
AUTOPOLL 



1050^ 



AUTOANSR 
AUTOCALL 
AUTOPOLL 



10522 

1053 

1060 



5, 6, or 7 
H 



AUTOPOLL 



-^ 



1130* 



AUTOANSR 
AUTOCALL 
AUTOPOLL 
DUALCODE 
DUALCOMM 



mo33 



2, 3, or N1 

7 



UNVCHSET 



1442 
1443 



-+- 



N1 or N2 
N1 



CARDIMAGE 



SELCHSET 
24ADDPOS 



2250 



ABSLTVEC 

ALKYB2250 

BUFFER4K or BUFFER 8K 

CHARGNTR 

DESIGNFEAT 

LIGHTPEN 

0PPAN1 or 0PPAN2 

PRGMKYBD 



ALKYB2250 

LIGHTPEN 

PRGMKYBD 



ALKYB2250 
PRGMKYBD 



2260 



1 or 2 



ALKYB2260 or NMKYB2260 
or DEKYB2260 



2280 
2282 



2301 
2302 



3 or 4 



2303 
2311 



(Continued; 
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Table 5. Keyword Values for the lODEVICE Macro-Instruction 

(Part 2 of 3) 
r — 



UNIT 
2314 



MODEL 



FEATURE 
2 -CHANS W 



I— 



2321 



H- 



2401 



1, 2, or 3 



READWRITE 
7- TRACK or 
MDECOMPAT 



9-TRACK 



4, 5, or 6 



READWRITE 
7-TRACK or 
DUALDENS 



9-TRACK 



H- 



2402 



1, 2, or 3 



READWRITE 
7-TRACK or 
MDECOMPAT 



9-TRACK 



4, 5, or 6 



READWRITE 
7-TRACK or 
DUALDENS 



9-TRACK 



2403 



1, 2, or 3 
4, 5, or 6 



7-TRACK or 
MDECOMPAT 



9-TRACK 



7-TRACK or 
DUALDENS 



9-TRACK 



2404** 



^, 2, or 3 



7-TRACK or 
7-TRACK or 



9-TRACK 
9-TRACK 



2415 



or 6 



2501 
2520 
2540R 



B1 or B2 

B1, B2, or B3 

1 



CARDIMAGE 
CARDIMAGE 



(Continued) 
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Table 5. Keyword Values for the lODEVICE Macro-Instruction 
(Part 3 of 3) 



UNIT 



MODEL 



FEATURE 



^ 



2540P 



I— 



2671 



-^ 



2740^ 



AUTOANSR 
AUTOCALL 
AUTOPOLL 
CHECKING 
SCONTROL or XCONTROL 



115A 



-H 



83B3 



-+- 



S360 



-+ 



AUTOANSR 
AUTOCALL 
DUALCODE 
DUALCOMM 



TWX 



AUTOANSR 
AUTOCALL 



^AUTOPOLL cannot be specified if either AUTOANSR or AUTOCALL (or 

both) is specified. 
^A 2150 used to connect a 1052 is addressed as the 1052, and may not 

be specified. 
^A 1U04 printer is supported only as a continuous form printer, and 

must be specified as a 1403, model 2. 
"♦The READWRITE feature is implicit for the 2U04 and must not be 

specified. 
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FEATURE=f eatur en 

specifies the optional features that are present on the device as 
one or more of the following values. These values can be written 
in any order. Features enclosed in braces { } are mutually 
exclusive. 



Value 

ABSLTVEC 

ALKYB2250 

{ALKYB2260 
DEKYB2260 
NMKYB2260 
AUTOANSR 

AUTOCALL 

AUTOPOLL 



I BUFFER UK | 

( BUFFER 8K J 

CARDIMAGE 

CHARGNTR 

CHECKING 

DESIGNFEAT 

DUALCODE 

DUALCOMM 

DUALDENS 

LIGHTPEN 

MDECOMPAT 

|0PPAN1 I 
I 0PPAN2 / 

PRGMKYBD 
READWRITE 

iSCONTROL I 
XCONTROL J 

SELCHSET 
UNVCHSET 
2-CHANSW 
( 7-TRACK 1 
\ 9-TRACK / 
24ADDPOS 



Feature 

Absolute vector control on 2250, model 1 

Alphameric keyboard on 2250 

I Alphameric keyboard on 2260 
Data entry keyboard on 2260 
Numeric keyboard on 2260 

Automatic answering capability for 1050, 1130, 2740, 
S3 60, or TWX 

Automatic calling feature for 1050, 1130, 2740, S360, 
or TWX 

Automatic polling feature for 1030, 1050, 1060, 1130, 
or 2740. If AUTOPOLL is specified for 2740, SCONTROL 
must also be specified. 

4096-byte buffer storage on 2250, model 1 
8192-byte buffer storage on 2250, model 1 
Card image on 1442, 2501, or 2520 
Character generator on 2250, model 1 
VRC/LRC checking on 2740 
Graphic design feature on 2250, model 1 
Decode and dual code feature for 1130, or S360 
Dual communication interface for 1130, or S360 
Dual density on model 4, 5, or 6 of 2401, 
Light pen detect on 2250, model 1 or 2 
Mode compatibility on model 1, 2, or 3 of 
or 2403 

First operator control panel on 2250, model 1 
First and second operator control panel on 2250, 
1 

Programmed function keyboard on 2250 
Simultaneous reading and writing on 2401, or 2402 
Station control feature on 2740. SCONTROL may not 
specified if AUTOANSR or AUTOCALL are specified. 
Transmit control feature on 2740. XCONTROL requires 
AUTOANSR, AUTOCALL or both. 
Selective character set on 1443 

Universal character set on 1403, model 2, 3, or N1 
2-channel switch on 2314 

7-track head on 2401, 2402, 2403, 2404, or 2415 
9-track head on 2401, 2402, 2403, 2404, or 2415 
24 additional print positions on 1443 



2402, or 2403 



2401, 2402, 



model 



be 



Notes : • Either 7-TRACK or 9-TRACK must be specified when the value of 
the-UNIT keyword is 2401, 2402, 2403, 2404, or 2415. 

• If AUTOPOLL is specified for the telecommuni^cations line, 
neither AUTOCALL nor AUTOANSR can be specified for that line. 

• If DUALDENS is specified, the generic unit names 2400 and 
2400-3 are generated in addition to 2400-4. 

ERRTAB=nnn 

specifies that an error routine, other than its standard error 
routine is to be used for the device. Either an IBM- supplied or a 
user-written routine may be specified. IBM error routines have the 
values 000 through 219, and 230 through 254. User-written routines 
can have the values 220 through 229. This value is the suffix of 
the name IGEOO under which the error routine is contained in 
SYS1.SVCLIB. (This parameter should be specified if UNIT=DUMMY is 
specified.) 
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DEVTYPE=type 

specifies any additional characteristics of the device. The value 
specified must not exceed eight hexadecimal characters- (This 
parameter should be specified if UNIT=DUMMY is specified.) For 
further information on this parameter, refer to the publication IBM 
System/360 Operating System: System Programmer's Guide , and to the 
description of the UCB in IBM System/ 3 60 Operating System; System 
Control Blocks , Form C28-6628. 

OPTCHAN=addresSn 

specifies the alternative channels through which a 2302, 2303, 
2311, 2314, 2401, 2U02, 2403, or 2404 may be addressed. Each value 
specified is the address of an alternative channel as specified in 
the CHANNEL macro- instruction. These values must be greater than 
the high order digit of the value of the ADDRESS keyword. (If the 
magnetic tape drive is attached to a 2403 or 2803 control unit, a 
2816 is required in order to have alternative channel addressing. 
In this case, the presence of the 2816 is implied when specifying 
the OPTCHAN parameter and it must not be specified elsewhere.) 
Only one alternative channel may be specified for 2302, 2303, 2311 
or 2314. A maximum of three alternative channels can be specified 
for magnetic tape drives. However, if the READWRITE feature is 
specified for the device, one and only one alternative channel may 
be specified. The addresses of alternative channels can be written 
in any order. 

Note: There must be only one lODEVICE macro-instruction for each I/O 
device, regardless of the number of alternative addresses given to the 
device. For example, if the primary address of a device is 181, and if 
it can also be addressed through channels 2, 3, and 4, there must not be 
separate lODEVICE macro-instructions defining the address of the device 
as either 281, 381, or 481. The primary address of the device, that is, 
the one with the lowest channel address, must be specified in the 
ADDRESS keyword. The other channel addresses must be specified with the 
OPTCHAN keyword. In this example, the macro-instruction for the device 
must contain the parameters ADDRESS=181 and OPTCHAN= (2 , 3 , 4) . 

TRNMODE 

specifies the data transmission mode for the device. BURST 
specifies the burst mode of data transmission. BYTE specifies the 
byte mode, i.e., multiplex mode of data transmission. This 
parameter must be specified if, and only if, the device is on a 
multiplexor channel and the device specified is an IBM 1443 
printer. Model N1. 

NUMSECT=number 

specifies the number of 256-byte buffer sections in the 2840 
control unit to be guaranteed available (that is, that can only be 
used by the device) to the 2250 (model 2 or 3) , 2280, or 2282. The 
value specified may range from 1 to a maximum value which is 
computed as follows: 

A - B + 1 



256 
where: 

A is the size of the buffer. 

B is the number of devices attached to the 2840. 

The total amount of buffer sections guaranteed to the devices 
attached to a 2840 must not exceed the number of sections in the 
buffer of that 2840. All sections not guaranteed to a device are 
available to all devices attached to the 2840. If this parameter 
is omitted, the device uses the sections not guaranteed to other 
devices; however, there must always be at least one section 
available (guaranteed or not) for assignment to each device. Note 
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that the assignment of guaranteed sections limits the amount of 
available contiguous sections. For further information, see the 
publication IBM System/360 Operating System: Graphic Programming 
Services for IBM 2250 Display Unit , Form C27-6909. 

ADAPTER=adapter 

specifies the terminal control or transmission adapter used to 
connect a telecommunications I/O device to its control unit. 



Value 
BSCA 

IBM1 

IBM2 

IBM3 
IBMT 

TELE1 

TELE 2 



Adapter or Control 

IBM Binary Synchronous Terminal Adapter Type II attach- 
ing an 1130, or S360 to a 2701, or IBM Binary 
Synchronous Terminal Control Type II attaching an 1130, 
or S360 to a 2703. 

IBM Terminal Adapter Type I attaching a 1050, 1060, or 
2740 to a 2701, or IBM Terminal Control Type I 
attaching a 1050, 1060, or 2740 to a 2702 or 2703 
IBM Terminal Adapter Type II attaching a 1030 to a 
2701, or IBM Terminal Control Type II attaching a 1030 
to a 2702 or 2703 

IBM Terminal Adapter Type III attaching a 2848/2260 to 
a 2701 

IBM Telegraph Adapter attaching a 1050 to a 2701, or 
IBM Terminal Control Type I and a Telegraph Line 
Adapter attaching a 1050 to a 2702 or 2703 
Telegraph Adapter Type I attaching a 115A or 83B3 to a 
2701, or Telegraph Terminal Control Type I attaching a 
115A or 83B3 to a 2702 or 2703 

Telegraph Adapter Type II attaching a TWX to a 2701, or 
Telegraph Terminal Control Type II attaching a TWX to a 
2702 or 2703 



SETADDR=value 

specifies the set address (SAD) command to be issued for a 
telecommunications line attached to a 2702 or 2703 control unit. 
This parameter is required if the device is attached to a 2702. 



Value 



Coirimand 



SADZERO 
SADONE 
SADTWO 
SADTHREE 



Examples : The following example illustrates the use of the lODEVICE 
macro-instruction to describe an IBM 1404 printer, model 2. The address 
of the device is 20E. 



IPRINTER2 lODEVICE UNIT=1 403 ,M0DEL=2 ,ADDRESS=20E 

L 



The following example illustrates the use of the lODEVICE macro- 
instruction to describe an IBM 2401 magnetic tape drive, model 3, with a 
9-track head. The address of the device is 181. This device can be 
addressed alternatively through channel 2. 

r 1 

I TAPE1 lODEVICE UNIT=240 1 ,ADDRESS=1 8 1 ,0PTCHAN=2 ,M0DEL=3 ,FEATURE=9-TRACK j 

L J 
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UNITNAME 

The UNITNAME macro-instruction is used to name a collection of I/O 
devices. A UNITNAME macro-instruction is required for each named 
collection of I/O devices in the system, except for generic unit names 
(see Appendix C) . A maximum of 50 uniquely named collections can be 
specified for the system. If more are required, see Appendix D for the 
procedure to be followed. This macro-instruction is optional. If 
selected, all UNITNAME macro- instructions having the same NAME value 
must appear together in the input stream. 

r T T 1 

I Name | Operation | Operand | 

|. 4 ^ ^ 

I I UNITNAME j UNIT= (address [, address] ...) j 

I I I NAME=name | 

L ± -L J 

Operand Field : 

UNIT=addresSn 

specifies the addresses of the I/O devices to be included in the 
collection. The addresses must be the same as those specified in 
the lODEVICE macro-instructions for these devices. The only 
combination of unlike device types permitted in a collection is 
magnetic tape and direct-access devices. The maximum number of 
devices that can be included in collections is determined by the 
following formula: 

A=510-N 
where: 

A is the maximum number of devices (a device may belong to more 
than one collection, but it must be counted as a separate 
device for each of the collections) . 

N is the number of uniquely named collections. (The maximum 
value of N is 50.) 

For example, if there are 40 collections, a maximum of 470 devices 
can be distributed among those collections. 

NAME=name 

specifies the name to be given to the collection of devices. The 
name may be from one to eight alphameric characters. 

Note : If the user intends to use IBM-supplied cataloged procedures, he 
must assign, using UNITNAME macro- instructions, certain names to collec- 
tions of I/O devices. These names will be used by the IBM-supplied 
cataloged procedures (contained in the procedure library) to specify the 
I/O devices required. The names to be specified follow. 

Name Types of I/O Devices in the Collection 

SYSSQ magnetic tape, direct-access 
SYSDA direct-access 
SYSCP card punch 

It is recommended that 2321 addresses not be included in the 
collections specified for SYSDA and SYSSQ because some of the processors 
(COBOL E, sort/merge, and RPG) do not support intermediate work data 
sets on 2321 volumes. It is also recommended that a collection of 
devices named SYSOUT be defined for intermediate system output data sets 
in MVT. The devices in the SYSOUT collection should be a subset of the 
devices in the SYSDA collection. (The SYSOUT unit name should also be 
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defined as the default value in the reader cataloged procedure for MVT.) 
For further information on the SYSSQ, SYSDA, SYSCP, and SYSOUT unit 
names see the section "System Reader and Writer Cataloged Procedures" in 
the publication IBM System/360 Operating System: System Programmer's 
Guide . 

Examples ; The following example illustrates the use of the UKITNAME 
macro-instruction to assign the name TAPE to the devices located at 180, 
181, 182, and 183. 

r ' 1 

I UNITNAME UNIT= (180, 181, 182,183) ,NAME=TAPE | 

L ; J 

The following example illustrates the use of the UNITNAME macro 
instruction to assign a specific unit name to an unsupported I/O device. 
The unsupported device is located at address 167 (specified as 
UNIT=DUMMY, ADDRESS=167 with an lODEVICE macro instruction) . 

r 1 

I I UNITNAME NAME=167,UNIT=167 | 

L_- J 
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CTRLPROG 

The CTRLPROG macro-instruction is used to specify control program 
options. This macro-instruction is required. 



I Name 
^ 



I Operation 
+ 

CTRLPROG 



j Operand 



(PCPl 

type=jmft[ 

( MVT ). 

MAXIO=number 



For TYPE=PCP or MFT only; 

OVERLAY=( BASIC )1 
\ ADVANCED fj 

fetch=( std |') 

(PClfJ 

For TYPE=MFT Only; 

HITASK=size 

LOWTASK= (size^u [ , sizeal [ , sizeg ] ) 

For TYPE=MVT only; 

[ QSPACE=number 3 
[ADDTRAN=nuitiber] 
[ OVERLAY=ASYCHRON ] 
[FETCH=PCI] 



._J 



Operand Field ; 



TYPE 



specifies the type of control program. PCP specifies the primary 
control program. MFT specifies multiprogramming with a fixed 
number of tasks. MVT specifies multiprogramming with a variable 
number of tasks. 



Note ; MVT can only operate on a Model 40, or above, central processing 
unit that has at least 256K bytes of main storage. The universal 
instruction set and the storage protection feature are also required. 



(See the CENPROCS macro-instruction.) 



MAXIO=number 

specifies the 
simultaneously 
is the sum of 
simultaneous ly 
being executed. 



maximum number of I/O operations that can be 
processed by the new operating system. This number 

those I/O operations that are being executed 
and those that are concurrently queued but are not 

(A recommended minimum value for MAXIO is the 



number of uniquely addressable I/O devices in the new system.) 



Note ; This number limits the maximum number of channel programs that 
can be started when using access methods or graphic programming 
seirvices. 

OVERLAY 

specifies overlay supervisor options. BASIC specifies synchronous 
overlay without exclusive call checking. ADVANCED specifies syn- 
chronous overlay with error checking for invalid SEGWT 
instructions . 
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Note ; If ADVANCED is specified, STORAGE=E must not be specified in the 
CENPROCS macro- instruction. 

FETCH 

specifies the type of program fetch. STD specifies standard fetch. 
PCI specifies the use of Program Controlled Interrupt while 
fetching a program into storage. 

HITASK=size 

specifies the size, in bytes, of the highest priority partition. 
The value specified must be a decimal integer, and it must also be 
a multiple of 8 that is equal to, or greater than, 61U4. 

LOWTASK=sizen 

specifies the sizes, in bytes, of one, two, or three low priority 
partitions. The value specified must be a decimal integer, and it 
must also be a multiple of 8 that is equal to, or greater than, 
6144. The last value specified must be at least as large as the 
scheduler design level specified with the DESIGN keyword of the 
SCHEDULR macro-instruction. 

Note: If PROTECT is specified as a value of the OPTIONS keyword of the 
SUPRVSOR macro-instruction, the values given to HITASK and LOWTASK must 
be multiples of 2048. 

QSPACE=number 

specifies the number of 2048-byte blocks required for the system 
queue area. If this parameter is omitted, a value of 10 is 
assumed. The value specified can be increased at IPL time if 
OPTION=COMM is specified in the SUPRVSOR macro-instruction. Refer 
to IBM System/360 Operating System; Storage Estimates for informa- 
tion on what value to specify for this parameter. 

ADDTRAN= number 

specifies the number, if any, of additional pairs of transient 
areas. Each area is 1024 bytes. 

OVERLAY=ASYCHRON 

specifies the asynchronous overlay supervisor for MVT. 

FETCH=PCI 

specifies PCI fetch for lyiVT. 

Examples ; The following example illustrates the use of the CTRLPROG 
macro-instruction to specify the primary control program. The maximum 
number of I/O operations that can be processed simultaneously is 20. 
The basic overlay supervisor and standard fetch are included. 

r 1 

I CTRLPROG MAXIO=20 j 

L J 

The following example illustrates the use of the CTRLPROG macro- 
instruction to specify multiprogramming with a variable number of tasks. 
The maximum number of I/O operations that can be processed simultaneous- 
ly is 30. The asynchronous overlay supervisor and PCI fetch are 
assumed. Fifteen 2K blocks are specified for the system queue area. 
There will be a total of six transient areas: the original pair plus 
two additional pairs. 

r 1 

\ CTRLPROG TYPE=MVT,MAXIO=30,QSPACE=15,ADDTRAN=2 j 

L J 
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SCHEDULR 

The SCHEDULR macro-instruction is used to specify job scheduler 
options. This macro-instruction is required. 



Name 



I Operation 

-+ 

SCHEDULR 



j Operand 

TYPE= SEQUENTIAL j 
[_ 1 PRIORITY 

CONSOLE=raddress ~ 1 

_ I {l-address,0-address)| ^ 

ALTCONS= I address 

I (l-address,0-address)j 
X)PTIONS=BYLABEL] 

;STARTR= (A-address [,V-serial] [,D-dsname] ) ] 
STARTW= (A-address [,V-serial] [,D-dsname] ) ] 
ACCTRTN= [NOTSUPPLIED 1 ] 
(SUPPLIED J J 
;WTOBFRS=number] 
;REPLY=number] 

For TYPE=SEQUENTIAL Only : 



DESIGN=]a4K 

(iook! 

RESJOBQ=number] 

CANCEL= (condition,, [, conditional ) ] 
OPSEPAR= (class [, class] ) ] 
( 200 "■ 



TSYSIN=j556 
(800 
200 



TSYSOUT=-(556 
800 

VL]yiOUNT=AVR 
200 



,1600 
,800 



TAVR=-(556 
800 



For TYPE=PRIORITY Only : 



STARTI= I manual! 



WTLCLSS= 
WTLBFRS= 
[PROCRES= 
JOBQRES= 
JOBQFMT= 

:jobqlmt= 
:jobqtmt= 

INITQBF= 
MINPART= 



AUTO 

classname] 

number] 

address] 

address} 

number] 

number] 

number] 

number] 

number] 



Operand Field : 



TYPE 



specifies the type of job scheduler as either SEQUENTIAL or 
PRIORITY. SEQUENTIAL must be specified if TYPE=PCP or TYPE=MFT is 
specified in the CTRLPROG macro-instruction. PRIORITY must be 
specified if TYPE=MVT is specified in the CTRLPROG 
macro-instruction. 
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CONSOLE 

specifies the address or addresses of the primary console device. 
If a composite console is used (e.g., a card reader and a printer) 
as the primary console, I-address specifies the address of the 
input device and 0-address specifies the address of the output 
device. The address value (s) must be the same as that specified 
for the device (s) in the lODEVICE macro-instruction (s) . 

ALTCONS=address 

specifies the address of an alternative console device. If a 
composite console is used as an alternative console, I-address 
specifies the address of the input device and 0-address specifies 
the address of the output device. If the primary console is a 
composite console, an alternative console cannot be specified for 
PCP. An alternative composite console can always be specified for 
MFT and MVT. The address value must be the same as that specified 
for the device in the lODEVICE macro-instruction. 

OPTI ONS=B YLABEL 

specifies that all label processing will be bypassed when the BLP 
parameter is specified in a DD statement. If OPTI ONS=B YLABEL is 
not specified, the BLP parameter will be processed in the same 
manner as NL. (For further information on this parameter, refer to 
the publication IBM System/360 Operating System; Job Control 
Language .) 

STARTR 

specifies that a START RDR command is to be executed automatically 
each time the new operating system is loaded into main storage 
after IPL. A-address specifies the address of the I/O device to be 
started. The address value must be the same as that specified for 
the device in the lODEVICE macro- instruction. V- serial specifies 
the serial number of the labeled volume associated with the I/O 
device. D-dsname specifies the name of the data set associated 
with the magnetic tape drive to be started. (D-dsname can only be 
specified if TYPE=PRIORITY is specified.) 

STARTW 

specifies that a START WTR command is to be executed automatically 
each time the new operating system is loaded into main storage 
after IPL. A-address specifies the address of the device to be 
started. The address value must be the same as that specified for 
the device in the lODEVICE macro- instruction. V-serial specifies 
the serial number of the labeled volume associated with the device. 
D-dsname specifies the name of the data set associated with the 
magnetic tape drive to be started'. (D-dsname can only be specified 
if TYPE=PRIORiTY is specified.) 

ACCTRTN 

specifies whether the user supplies an accounting routine. NOTSUP- 
PLIED specifies that the user does not intend to provide an 
accounting routine. SUPPLIED specifies that the user supplies (or 
will supply after system generation) an accounting routine. (For 
further information on accounting routines, refer to the publica- 
tion IBM System/360 Operating System: System Programmer's Guide .) 

WT OBFRS=number 

specifies the number of buffers to be used by the WTO routines. 
Each write buffer is 144 bytes. If this parameter is omitted, a 
value of 5 is assumed for MFT, or of 100 for MVT. 
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REPLY=nuinber 

specifies the number of reply queue elements to be used by the WTOR 
routines. Each reply queue element is 2U bytes. If this parameter 
is omitted, a value of 5 is assumed for MFT, or of 100 for MVT. 

Note ; WTOBFRS and REPLY can be specified if, and only if, TYPE=]yiFT or 
MVT is specified in the CTRLPROG macro-instruction. 

DESIGN 

specifies the design level (in bytes) of the sequential job 
scheduler. 

RESJOBQ=number 

specifies the inclusion of portions of SYS1 .SYSJOBQE in the 
nucleus. The value specified is the number of 176-byte records to 
be resident. 

CANCEL 

specifies conditions under which a job is to be canceled without 
being executed. NONAME specifies that a job is to be canceled if 
the programmer's name field is omitted from the JOB statement. 
NOACCNUM specifies that a job is to be canceled if the account 
number field is omitted from the JOB statement. 

Note: The conditions for canceling jobs for the priority scheduler are 
specified in the PARM field of the EXEC statement of the START RDR 
procedure. 

OPSEPAR 

specifies the inclusion of IBM-supplied separator routines. A 
specifies that the routines are to be used for system output class 
A; B that the routines are to be used for system output class B. 

TSYSIN 

specifies the standard magnetic tape density for the system input 
unit in characters per inch. This parameter applies only to 
7-track magnetic tape, 

TSYSOUT 

specifies the standard magnetic tape density for the system output 
unit in characters per inch. The first positional parameter refers 
to 7-track magnetic tape. The second positional parameter refers 
to dual density magnetic tape. 

Note: If either system input or output is on 7-track magnetic tape, the 
drives must have the data conversion feature. The standard magnetic 
tape densities for the priority scheduler are specified by DD statements 
in the START RDR and START WTR procedures. 

VLMOUNT=AVR 

specifies automatic volume recognition for the volume mounting 
procedures. 

TAVR 

specifies the standard density for magnetic tapes used with 
automatic volume recognition. (This parameter applies only to 
7-track magnetic tape.) This parameter may be specified only if 
VLMOUNT=AVR is specified. 

STARTI 

specifies whether a START INIT command is to be executed automatic- 
ally each time the new operating system is loaded into main storage 
after IPL. AUTO specifies that the command is to be executed 
automatically; MANUAL specifies that it is not to be executed 
automatically. 
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WTLCLSS=classnaine 

specifies the classname to be used as a default for SYSOUT for 
write-to-log (WTL) messages. The value specified must be a letter 
from A through Z, or a number from through 9. If this parameter 
is omitted, L is assumed. (If A is specified, SYSOUT and WTL 
messages will be interspersed.) 

WTLBFRS=number 

specifies the maximum number of internal buffers to be used for WTL 
messages if neither SYS 1 . SYSVLOGX nor SYS 1 . SYSVLOGY is available. 
(If the internal buffers specified are exhausted during execution, 
the oldest WTL message in the buffers will be written on the 
console, and the latest message will be written in the buffer.) 
The value specified must be an integer greater than or equal to 0. 
If this parameter is omitted, a value of 2 is assumed. If is 
specified all messages are written on the console. 

PROCRES=address 

specifies the address of the device on which SYS1.PR0CLIB resides. 
If this parameter is omitted, the address of the system residence 
device is, assumed. The address must be the same as that specified 
for the device in the lODEVICE macro- instruction. The address 
specified can be changed when the scheduler is made ready after 
IPL. 

JOBQRES=address 

specifies the address of the device on which SYS 1 . SYS JOBQE resides. 
If this parameter is omitted, the address of the system residence 
device is assumed. The address must be the same as that specified 
for the device in the lODEVICE macro-instruction. The address 
specified can be changed when the scheduler is made ready after 
IPL. 

JOBQFMT=number 

specifies the format of SYS 1 .SYS JOBQE, the value is the number of 
176-byte records to be included in a logical track of SYS1. 
SYSJOBQE. The value specified must be an integer from 10 to 255. 
If this parameter is omitted, a value of 12 is assumed. The value 
specified can be changed when the scheduler is made ready after 
IPL. Refer to IBM System/360 Operating System; System Program- 
mer's Guide for information on how to specify a value for this 
parameter. 

JOBQLMT=number 

specifies the number of 176-byte records in SYS 1 . SYS JOBQE to be 
reserved for each initiator started. The value specified must be 
an integer less than or equal to 9999. If this parameter is 
omitted, a value of 60 is assumed. The value specified can be 
changed when the scheduler is made ready after IPL- Refer to IBM 
System/360 Operating System: System Programmer's Guide for infor- 
mation on how to specify a value for this parameter. 

Note: A job is terminated if the number of records required to initiate 
it exceeds the value specified. It is recommended that the value 
specified for JOBQLMT be a multiple of the value given to JOBQFMT. 

JOBQTMT=number 

specifies the number of 176-byte records in SYS 1 . SYS JOBQE to be 
reserved for the termination of jobs that require more records for 
initiation than those specified in JOBQLMT. The value specified 
must be an integer less than or equal to 9999. If this parameter 
is omitted, a value of 60 is assumed. The value specified can be 
changed when the scheduler is made ready after IPL. Refer to IBM 
System/360 Operating System: System Programmer's Guide for infor- 
mation on how to specify a value for this parameter. 
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INITQBF=nuinber 

specifies the number of 1024- byte buffers, if any, to be used for 
maintaining portions of SYSl.SYSJOBQE in main storage. The value 
specified must be an integer from to 255. The value given must 
be great enough to hold one logical track (specified with JOBQFMT) ; 
otherwise, no buffering will occur. This parameter can also be 
specified, or changed at IPL time if OPTIONS=COMM is specified in 
the SUPRVSOR macro-instruction. Refer to IBM System/360 Operating 
System: Storage Estimates for information on how to specify a 
value for this parameter. 

MINPART=blocks 

specifies the number of 1024-byte blocks of main storage required 
for the minimum region for a job. The value specified must be an 
integer equal to or greater than 52 plus the value of INITQBF. If 
this parameter is omitted, a value of 52 is assumed. The value 
specified can be changed at IPL time if OPT IONS =CO]yiM is specified 
in the SUPRVSOR macro-instruction. Refer to IBM System/360 Operat- 
ing System; Storage Estimates for information on how to specify a 
value for this parameter. 

Examples : The following example illustrates the use of the SCHEDULR 
macro- instruction to specify the 18K design level of the sequential job 
scheduler. The address of the console device is OIF. The address of an 
alternative console is 21F. The START RDR command is to be executed 
after the system is loaded into main storage. The device to be started 
is located at 181. The standard magnetic tape density for system input 
and output is 200 characters per inch. The user will supply an 
accounting routine. In addition, the macro- instruction is used to 
specify the cancellation of all jobs whose account nuiriber is omitted. 

r 1 

I SCHEDULR CONSOLE=01F,ALTCONS=21F,STARTR=A-181,ACCTRTN=SUPPLIED, j 
I CANCEL=NOACCNUM | 

L J 

The following example illustrates the use of the SCHEDULR macro- 
instruction to specify the priority job scheduler required for multipro- 
gramming with a variable number of tasks (MVT) . The address of the 
primary console is OlA. A composite console is used as an alternative 
console; its input address is OOC and its output address is OOD. An 
accounting routine will not be supplied. START RDR and START WTR 
commands are to be executed automatically after IPL. The devices to be 
started are located at OOE and OOF, respectively. 75 buffers are to be 
used by WTO routines. 75 reply queue elements are to be used by WTOR 
routines. A START INIT command is to be executed automatically after 
IPL. The classname for WTL messages is L. A maximum of 20 buffers are 
to be used for WTL messages. SYSl.SYSJOBQE and SYSl.PROCLIB are located 
on the system residence device. The format of SYSl.SYSJOBQE will be the 
following: twenty 17 6 -byte records for each logical track. Eighty 
176-byte records (4 logical tracks) will be reserved for each initiator 
started, and eighty 176-byte records will be reserved for the termina- 
tion of jobs that require more than 80 records for initiation. Fifteen 
102U-byte buffers are requested for SYSl.SYSJOBQE. Sixty-seven 1024- 
byte blocks are required to process a job (52 plus 15 INITQBF buffers). 

r T 

I SCHEDULR TYPE= PRIORITY, CONSOLE=01A,ALTCONS= (I- OOC, O- OOD) , j 

I STARTR=A-00E,STARTW=A-00F,WTOBFRS=75,REPLY=75, | 

I STARTI=AUTO,WTLBFRS=20,JOBQFMT=20,JOBQLMT=80, | 

JOBQTMT= 8 , INITQBF=1 5 , MINPART=6 7 
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SUPRVSOR 

The SUPRVSOR macro-instruction is used to select task supervisor 
options. This macro-instruction is optional. 

For assistance in choosing valid task supervisor options for PCP, 
MFT, and MVT, refer to Table 6. 



I Operation 

-+ 

SUPRVSOR 



J Name 

|. + ^ 



j Operand 

-+- 

[RESIDNT= (function [ , function] . . . ) 3 

tOPTIONS= ( option [, opt ion] )] 

rWAIT= ( SINGLE V\ 

L (multiple/J 

r ( TIME - i-j 

TI]y!ER= ]iNTERVAl[ 
L /jOBSTEP y 

[TRACE=number] 
rSER=(SERO)"| 
L (SERllJ 

L ± ± J 



Operand Field : 

RESIDNT=functionn 

specifies that one or more of the following routines, normally 
executed from the transient area, are to be included in the 
resident portion of the control program. The values are ATTACH, 
EXTRACT, IDENTIFY, and SPIE. The following values can also be 
specified; they refer to functions that can be made resident at IPL 
time: 



Value 



IPL Time Function 



BLDLTAB Directory entries for selected SYSl.LINKLIB modules are 
to be resident. 



ACSMETH Access method modules to be loaded and made part of the 
nucleus. This value must not be specified if TYPE=MVT 
is specified in the CTRLPROG macro-instruction. 

RENTCODE Any module in SYSl.LINKLIB or SYSl.SVCLIB can be made 
resident- This value can only be specified if TYPE=MVT 
is specified in the CTRLPROG macro- instruct ion. 



TRSVC 



Type 3 and 
resident. 



4 SVC modules are to be loaded and made 



The use of these options is discussed in the publication IBM 
System/360 Operating System: System Programmer's Guide . 

Note : ATTACH, EXTRACT, IDENTIFY, and SPIE are assumed if TYPE=MVT is 
specified in the CTRLPROG macro- instruction. 



62 



OPTIONS=optionn 

specifies task supervisor options as one or more of 
values. These values may be listed in any order. 



the following 



Value 



Option 



IDENTIFY The IDENTIFY function is to be included. If IDENTIFY 
is specified as a value of the RESIDNT keyword, it need 
not be specified as a value of the OPTIONS keyword. 

TRSVCTBL A table containing the relative track addresses of all 
transient SVCs is to be stored in the resident portion 
of the control program. This value must be specified 
if TRSVC is specified in the RESIDNT keyword. 

PROTECT Specifies the inclusion of the protect function when 
the protect feature is part of the central processing 
unit. This value must be specified for MVT. (PROTECT 
includes the VALIDCHK option if TYPE=PCP or MFT are 
specified in the CTRLPROG macro-instruction. ) 

VALIDCHK The WAIT, POST, and GETMAIN/FREEMAIN modules are to 
contain extra validity checking to determine whether 
addresses are located within proper boundaries. The 
validity checking for WAIT also checks for the number 
of events. VALIDCHK should not be specified if PROTECT 
is specified. 

C0MI4 Specifies communication with the operator at IPL time 
for the purpose of changing certain system generation 
options. The options that can be changed at IPL time 
are BLDLTAB, ACSMETH, RENTCODE, and TRSVC from the 
SUPRVSOR macro-instruction; MINPART and INITQBF from 
the SCHEDULR macro- instruction; and QSPACE from the 
CTRLPROG macro-instruction. (BLDLTAB, ACSMETH, 
RENTCODE, and TRSVC can only be changed if they are 
specified in the RESIDNT keyword.) The communications 
procedure is described in the publication IBM System/ 
360 Operating System: Operator's Guide under the 
discussion of NIP messages. 

ONLNTEST specifies the inclusion of the On-Line Test system 
function. This function allows the running of I/O 
device tests under the operating system as a job step. 
(The on-line tests are contained in a separate data 
set, and must be obtained from the IBM Branch Office 
representative. ) 

Note: IDENTIFY and TRSVCTBL are assumed if TYPE=MVT is specified in the 
CTRLPROG macro-instruction; VALIDCHK is invalid; PROTECT is required - 



WAIT 



specifies, as either SINGLE or MULTIPLE, the number of events that 
can be specified in a WAIT macro-instruction. MULTIPLE is assum.ed 
if TYPE=MVT is specified in the CTRLPROG macro-instruction; SINGLE 
is invalid. 



TIMER 



specifies the inclusion of the timer function when the timer 
feature is part of the central processing unit. TIME provides the 
ability to request date plus time of day in various units of 
measurement. INTERVAL provides the same functions, plus the 
ability to request, check, and cancel intervals of time. JOBSTEP 
provides timing of each job step and enforcement of job step time 
limits . 
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Note ; Either INTERVAL or JOBSTEP must be specified if TYPE=MVT is 
specified in the CTRLPROG macro- instruction; JOBSTEP is invalid if 
TYPE=PCP or MET is specified. 

TRACE=number 

specifies the inclusion of an optional trace table. The value is 
the number of entries in the table. (See the publication IBM 
System/360 Operating System; System Programmer's Guide for a 
description of the trace table.) 



SER 



specifies the system environment recording (SER) level desired. 
Either SERO or SERl may be specified. If this parameter is 
included, the nucleus generated is CPU dependent, that is, it can 
only be used in the CPU model specified in the CENPROCS macro- 
instruction. (This parameter is valid only on models 40, 50, 65, 
and 75.) For further information on this parameter, refer to the 
publication IBM System/36 Operating System; Storage Estimates . 



Table 
r 



6. 
Keyword 



SUPRVSOR Macro- Instruction Values 

T T T- 



for PCP, MET, 

T" 



and MVT 



Value 



PCP 



MET 



MVT 



j. ^ 1 1 + 









ATTACH 




Optional 




Optional 




Assumed 










EXTRACT 




Optional 




Optional 




Assumed 










IDENTIFY 




Optional 




Optional 




Assumed 






RESIDNT 




SPIE 

BLDLTAB 

ACSMETH 

RENTCODE 

TRSVC 




Optional 

Optional 

Optional 

Invalid 

Optional 




Optional 

Optional 

Optional 

Invalid 

Optional 




Assumed 

Optional 

N/A 

Optional 

Optional 




h- 


OPTIONS 


— +- 


IDENTIFY 

TRSVCTBL 

PROTECT 

VALIDCHK 

COMM 

ONLNTEST 


--+- 


Optional 
Optional 
Optional 
Optional 
Optional 
Optional 


— +- 


Optional 
Optional 
Optional 
Optional 
Optional 
Optional 


-+- 


Assumed 

Assumed 

Required 

Invalid 

Optional 

Optional 


•H 


1— 


WAIT 


~+- 


SINGLE 


-+- 


Optional 


—+- 


Optional 


-+- 


Invalid 


H 


1— 




~+- 


MULTIPLE 


1 


Optional 


~+- 


Optional 


-+- 


Assumed 


--1 




TIME 


Optional 


Optional 


Invalid 


H 


TIMER 


~+- 


INTERVAL 
JOBSTEP 


--+- 


Optional 
Invalid 


--+- 


Optional 
Invalid 


-+- 


Optional^ 
Optional^ 


--! 




TRACE 




number 




Optional 




Optional 




Optional 




1 




J. 




_ J. 




x 




. 1 




■H 


1 




T 




t 




T 




T 






SER 




SERO 
SERl 




Optional 
Optional 




Optional 
Optional 




Optional 
Optional 





. X X -L ± J 

I ^Either INTERVAL or JOBSTEP 

L 



must be specified for MVT. 



6U 



Examples ; The following example illustrates the use of the SUPRVSOR 
macro- instruction to specify task supervisor options for the primary 
control program (PCP) or for multiprogramming with a fixed number of 
tasks (MFT) . A table containing the relative track addresses of 
transient SVCs is to be stored in the resident portion of the control 
program. The IDENTIFY and the ATTACH functions are to be included in 
the resident portion of the control program. Multiple events can be 
specified in a WAIT macro-instruction. There are 100 entries in the 
trace table. 

J. ^ 

I SUPRVSOR OPTIONS=TRSVCTBL, RESIDNT=( IDENTIFY, ATTACH) ,WAIT=iy!ULTIPLE, j 
I TRACE=100 I 

L : J 

The following example illustrates the use of the SUPRVSOR macro- 
instruction to specify task supervisor options for multiprogramming with 
a variable number of tasks (MVT) . It is assumed that ATTACH, EXTRACT, 
IDENTIFY, and SPIE are to be made resident. Resident type 3 and 4 SVC 
routines are to be loaded and made resident at IPL time. The IDENTIFY 
function and a table of the relative track addresses of all transient 
SVCS are assiimed. The protect function is required. The operator may 
change TRSVC, MINPART, INITQBF, and QSPACE, but not RENTCODE and 
BLDLTAB. MULTIPLE events are assumed for the WAIT macro- instruction. 
Timing of each job step is selected. There are 150 entries in the trace 
table. SERl is to be used. 

r 1 

I SUPRVSOR RESIDNT=TRSVC,TIMER=JOBSTEP,TRACE=150,SER=SER1, | 

I 0PTI0NS= (PROTECT, COMM) | 

L J 
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SVCTABLE 

The SVCTABLE macro- instruction is used to specify the number, type, 

and SVRB extended save area of the user- written supervisor call (SVC) 

routines that are to be added to the new operating system. This 
macro- instruction is optional. 



r T T ' 1 

I Name | Operation | Operand | 

J. ^ 1 ^ 

I I SVCTABLE I operand [, operand] .. . | 

L X JL J 



Operand Field ; Each operand must be written in the following format: 

SVC-nnn-Ta-Sb 

Upper case letters and hyphens (-) must be written exactly as shown. 

nnn 

specifies the SVC number as a decimal integer. The highest SVC 
number that may be assigned is 255. The user must assign unique 
numbers to his SVC routines, and should assign them in descending 
order starting with 255 and ending with 200 to avoid conflict with 
the numbers assigned to IBM-written SVC routines. 



specifies the SVC type as either 1, 2, 3, or 4. 



specifies the size of the extended save area of the SVRB associated 
with the SVC routine. The value indicates the number of double 
words by which the SVRB is to be extended. A type 1 SVC must have 
a value of 0. Types 2, 3, and U can have a value of from to 6. 

Note : For each type 1 or type 2 SVC, there should be a corresponding 
module specified in the RESMODS macro- instruction; one module may 
contain more than one resident SVC routine. For each type 3 SVC, there 
should be a corresponding module specified in the SVCLIB macro- 
instruction; each module may contain only one transient SVC routine. 
For each type U SVC, there should be one corresponding module specified 
in the SVCLIB macro-instruction for each load module of the SVC routine. 
(For further information on user-written SVC routines refer to the 
publication IBM system/360 Operating System: System Programmer's 
Guide . ) 

Example ; The following example illustrates the use of the SVCTABLE 
macro-instruction to specify that four user-written SVCs are to be added 
to the operating system to be generated. 



r 1 

I SVCTABLE SVC-255-T4-S5,SVC-25U-T2-S3,SVC-253-T3-Sl,SVC-252-Tl-S0 | 

L J 
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RESMODS 

The RESMODS macro- instruct! on is used to add user-written routines, 
in load module form, to the nucleus library (SYSl. NUCLEUS) to be 
generated. Before these load modules can be included in the nucleus 
library, they must be members of a partitioned data set. This data set 
must have been cataloged, as SYSl. name, in the generating system. This 
macro- instruction is optional. 



r T T 1 

I Name | Operation ] Operand | 

|. + ^ ^ 

I I RESMODS I PDS=SYSl.name | 

I I I MEMBERS= (name t , name] . . . ) j 

L J. X J 



Operand Field : 

PDS=SYSl.name 

specifies the name of the partitioned data set that contains the 
load modules to be included. The value of name cannot exceed eight 
alphameric characters, the first of which must be alphabetic. 

MEMBERS=namen 

specifies the simple names of the members to be included. The 
value of name cannot exceed eight alphameric characters, the first 
of which must be alphabetic. A maximum of ten load modules 'can be 
included in the nucleus library. 

Note: If resident SVC routines are being included, each load module can 
contain more than one SVC routine. The type, number, and SVRB extended 
save area of each of the resident SVC routines to be included must be 
specified in the SVCTABLE macro- instruction. (For further information 
on user- written SVC routines, refer to the publication IBM System/360 
Operating System: System Programmer's Guide . ) 

Example : This example illustrates the use of the RESMODS macro- 
instruction to include the load modules CONTROL and lORTN in the nucleus 
library. These modules are members of the SYSl. NEW partitioned data 
set. 



1 

RESMODS PDS=SYS1. NEW, MEMBERS= (CONTROL, lORTN) | 

J 
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SVCLIB 

The SVCLIB macro-instruction is used to add transient user-written 
routines, in load module form, to the SVC library (SYSl. SVCLIB) during 
system generation. Before these routines can be included in the SVC 
library they must be members of a partitioned data set. This data set 
must have been cataloged, as SYSl. name, in the generating system. The 
number, type, and SVRB extended save area of each of the SVC routines to 
be added must be specified in the SVCTABLE macro-instruction. The 
SVCLIB macro- instruction is optional. 



r T T T 

I Name | Operation | Operand | 

j. ^ + ^ 

I I SVCLIB I PDS=SYSl.name j 

I j I MEMBERS=( name [, name] ) | 

L J. J. J 

Operand Field : 

PDS=SYSl.name 

specifies the name of the partitioned data set that contains the 
routines to be added. The value of name cannot exceed eight 
alphameric characters, the first of which must be alphabetic. 

i4EMBERS=namen 

specifies the names of the members to be added. Each name (unless 
referring to nonstandard label routines) must be of the form: 

IGCssnnn 

where : 

ss 

is the number of the load module minus one, e.g., the second 
load module has a value of 01. The value of ss is always 00 
for type 3 SVC routines. 

nnn 

is an SVC number, nnn must be a signed decimal integer (e.g., 
242=24B) if the routine is called directly by SVC. 

The names of nonstandard label routines must begin with NS and can 
not exceed eight alphameric characters. With this macro- 
instruction, a maximum of 50 members may be added to the SVC 
library. (For further information on user-written SVC routines and 
nonstandard label routines refer to the publication IBM System/360 
Operating System; System Programmer's Guide . ) 

Example ; The following example illustrates the use of the SVCLIB 
macro-instruction to add the routines named IGC0025E, IGC0025D, 
IGC0025C, and IGC0025B to the SVC library. These routines are members 
of the SYSl.USERSVC partitioned data set, and are called directly by ^ 
SVC. 



r 1 

I SVCLIB PDS=SYSl.USERSVC,MEMBERS=(IGC0025E,IGC0025D,IGC0025C, | 
I IGC0025B) I 

L : . J 
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PROCLIB 

The PROCLIB irjacro-instruction is used to specify the inclusion of the 
procedure library (SYSl. PROCLIB) in the new operating system. SYSl. 
PROCLIB must be allocated space and, if desired, cataloged in the new 
system during the preparation for system generation. This library must 
also exist as a cataloged partitioned data set (SYSl. PROCLIB) in the 
generating system. This macro-instruction is optional. If not chosen, 
a null data set must be made available to the generated system. (See 
"Input Deck for Initialization" in the section "Preparation for System 
Generation.") If IBM-supplied cataloged procedures are to be used, 
certain names must be assigned to collections of devices. Refer to the 
description of the UNITNAME macro-instruction for a list of these names. 



r T T 1 

I Name | Operation j Operand | 

|. 1 ^ ^ 

I I PROCLIB I [UNIT=name] | 

I I I [VOLNO=serial] j 

L X J. J 



Operand Field ; 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the procedure 
library being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 
procedure library. The value specified must be the same as the 
value given to the VOLUME keyword of the DD statement used to 
allocate space for SYSl. PROCLIB during the preparation for system 
generation. 

Note ; If these parameters are omitted, the procedure library is placed 
on the new system residence volume. (If one of these parameters is 
specified, both must be specified.) 

Example : This example illustrates the use of the PROCLIB macro- 
instruction to specify the inclusion of the procedure library in the 
operating system to be generated. The unit name is 2311. The volume 
serial number is 909090. 



r 1 

j PROCLIB UNIT=2 311, V0LN0=9 09090 | 

L J 
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LINKLIB 

The LINKLIB macro- instruction is used to add user-written routines, 
in load module form, to the link library (SYSl. LINKLIB) during system 
generation. Before these routines can be included in the link library, 
they must be members of a partitioned data set. This data set must have 
been cataloged, as SYSl. name, in the generating system. This macro- 
instruction is optional. 



r T T 1 

j Name | Operation | Operand | 

i. 1 1 ^ 

I I LINKLIB I PDS=SYS1 . name j 

I I I ]yjEMBERS= (name t , name] ) | 

L -L X J 



Operand Field ; 

PDS=SYSl.name 

specifies the name of the partitioned data set that contains the 
routines to be added. The value of name cannot exceed eight 
alphameric characters, the first of which must be alphabetic. 

MEMBERS=namen 

specifies the names of the members to be added. The value of name 
cannot exceed eight alphameric characters, the first of which must 
be alphabetic. With this macro- instruction, a maximum of 20 
routines may be included in the link library during one system 
generation process. 



Example ; The following example illustrates the use of the LINKLIB 
macro-instruction to add the routines PAYROLL, COMPILER, and MULT to the 
link library. These routines are members of the SYSl. USER partitioned 
data set. 



j LINKLIB PDS=SYSl . USER, MEMBERS= (PAYROLL, COMPILER, MULT) 
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DATAMGT 

The DATAMGT macro- in Struct ion allows the user to specify optional 
access methods. This macro- instruction is optional. 



r T T 1 

I Name | Operation | Operand | 

|. 4. + ^ 

I I DATAMGT | ACSMETH= (method [, method] ... ) j 

L J. X J 



Operand Field : 

ACSMETH=methodn 

specifies the optional access methods to be included as one or more 
of the following values. These values may be listed in any order. 

Value Access Method 

BDAM Basic direct access method (BDAM) and routines for 

creating a direct data set. 
ISAM Queued and basic index seqxiential access methods (QISAM 

and BISAM) . 
BTAM Basic telecommunications access method (3TAM) . 
QTAM Queued telecommunications access method (QTAM) . 

Note: BTAM and QTAM require the telecommunications library. The 
generation of SYSl.TELCMLIB is specified with the TELCMLIB macro- 
instruction. If QTAM is specified, TYPE=MFT or MVT must be specified in 
the CTRLPROG macro-instruction, and ■WAIT=MULTIPLE and TIME=INTERVAL must 
be specified in the SUPRVSOR macro-instruction. 



Example : The following example illustrates the use of the DATAMGT 
macro-instruction to specify that the basic direct access method is to 
be included in the operating system to be generated. 



r 1 

I DATAMGT ACSMETH=BDAM | 

L J 
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TELCMLIB 

The TELCWLIB macro- instruction is used to specify the inclusion of 
the telecommunications subroutine library in the new operating system. 
SYSl . TELCMLIB must be allocated space and, if desired, cataloged in the 
new system during the preparation for system generation. This macro- 
instruction is optional. 



r T T 1 

I Name \ Operation | Operand | 

|. 4. 1 ^ 

j I TELCMLIB I [UNIT=name] j 

I I I [VOLNO=serial] | 

L i. X J 



Operand Field : 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the telecommunica- 
tions subroutine library being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 
telecommunication subroutine library. The value specified must be 
the same as the value given to the VOLUME keyword of the DD 
statement used to allocate space for SYSl .TELCMLIB during the 
preparation for system generation. 

Note: If these parameters are omitted, the telecommunications subrou- 
tine library is placed on the new system residence volume. (If one of 
these parameters is specified, both must be specified.) 

Example : This example illustrates the use of the TELCMLIB macro- 
instruction to specify the inclusion of the telecommunications subrou- 
tine library in the operating system to be generated. SYSl. TELCMLIB is 
to reside on the new system residence volume. 



r 

I TELCMLIB 

L 
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GRAPHICS 

The GRAPHICS macro-instruction is used to specify the inclusion of 
Graphic Programming Services. This macro-instruction is optional. 



Name 



I Operation 

-+ 

I GRAPHICS 



j Operand 

I PORRTNS= / include \] 

I Iexclude/J 

I |gs P= ( exclude m 

(INCLUDE/ J 



.± t. 



Operand Field ; 

PORRTNS 

specifies the inclusion of problem orientea routines (PORs) in 
SYSl.LINKLIB. INCLUDE specifies that the PORs are to be included; 
EXCLUDE, that PORs are not to be included. 



GSP 



specifies the inclusion of the FORTRAN IV Graphic Subroutine 
Package (GSP) in SYSl.LINKLIB and SYSl. FORTLIB. INCLUDE specifies 
that GSP is to be included; EXCLUDE that GSP is not to be included. 



Example; The following example illustrates the use the GRAPHICS 
macro- instruction to specify the inclusion of Graphic Programming 
Services in the operating system to be generated. Problem oriented 
routines are to be included in SYSl.LINKLIB. GSP is not to be included. 



GRAPHICS 
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SYSUTILS 

The SYSUTILS macro-instruction is used to specify the amount of main 
storage available to the system and data set utilities. System and data 
set utilities are generated with every operating system and they will 
operate in 15K bytes of main storage unless tnis macro-instruction is 
used to specify a larger amount. This macro-instruction is optional. 



r T T 1 

I Name | Operation j Operand | 

|. + + ^ 

I j SYSUTILS I SlZE=size | 

L J. ± J 



Operand Field : 

SIZE=size 

specifies the amount of main storage, in bytes, available to the 
system and data set utilities. The value specified must be an 
integer of from 15360 to 999999, or it may be of the form nnnnK 
where nnnn is an integer of from 15 to 9999 and K represents 1024 
bytes. If this parameter is om.itted, a value of 15360 is assumed. 

Example ; The following example illustrates the use of the SYSUTILS 
macro- instruction to specify that there are 44K bytes of main storage 
available to the system and data set utilities. 



r 1 

I SYSUTILS SIZE=U4K | 

L J 
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EDITOR 

The EDITOR macro- instruction is used to specify the inclusion of the 
linkage editor. This macro-instruction is optional. This macro- 
instruction must be issued once for each design level to be generated. 

IEWLE150, IEWLE180, and lEWLSUUO are the names of the 15K, 18K, and 
44K E-design- level linkage editors. The alias lE'WL (used for cataloged 
procedures) and the alias LINKEDIT (used for supervisor assisted 
linkages) are given to the linkage editor chosen or, if more than one is 
chosen, it is given to the largest. 

The cataloged procedures for MVT assume the E44 linkage editor. If 
the E4U linkage editor is not chosen, the REGION parameter of the 
cataloged procedures should be changed using the lEBUPDTE utility 
program described in the publication IBM System/3 60 Operating System: 
Utilities . Region sizes are given in the publication IBM System/360 
Operating System: Storage Estimates . 



r T T 1 

I Name | Operation j Operand | 

^ + + -I 

j I EDITOR I (El5j I 

j I I DESIGN=<E18; I 

I I I (e44) I 

L ± ± J 



Operand Field : 

DESIGN 

specifies the design level of the linkage editor to be included. 
E15 specifies the E-design- level linkage editor that operates in 
15K bytes of main storage. E18 specifies the E-design- level 
linkage editor that operates in 18K bytes of main storage. E44 
specifies the E-design-level linkage editor that operates in U4K 
bytes (or more) of main storage. 



Example : The following example illustrates the use of the EDITOR 
macro- instruction to specify the E-design-level linkage editor that 
operates in 18K bytes of main storage. 



r { T 

I EDITOR DESIGN=E18 | 

L , J 
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ASSEMBLR 

The ASSEMBLR macro- instruction is used to specify the inclusion of 
the assembler language processor. This macro-instruction is optional. 
However, it must be issued once for each design level to be generated. 

lETASM and lEUASM are the names of the assembler E and assembler 
F, respectively. The alias ASMBLR is given to the assembler chosen or, 
if both are chosen, it is given to assembler F. 

The cataloged procedures for MVT assume the assembler F processor. 
If assembler F is not chosen, the REGION parameter of the cataloged 
procedures should be changed using the lEBUPDTE utility program 
I described in the publication IBM System/360 Operating System; utili- 
ties . Region sizes are given in the publication IBM System/360 
Operating System: Storage Estimates . 



r T T 1 

I Name | Operation 1 Operand | 

|. ^ + ^ 

j I ASSEMBLR | DESIGN=/EJ. | 

I I I (F/ I 

L J. J. ^^J 



Operand Field ; 

DESIGN 

specifies the design level of the assembler language processor as E 
or F. 

Note ; The E-design-level of the assembler language processor requires 
an unblocked macro library (SYSl.MACLIB) . If the E-design-level 
assembler language processor is to be used for future system genera- 
tions, SYSl.GENLIB must also be unblocked. 



Example; The following example illustrates the use of the ASSEMBLR 
macro-instruction to specify the E design level of the assembler 
language processor. 



r 

I ASSEMBLR DESIGN=E 
L 
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TESTRAN 

The TESTRAN macro-instruction is used to specify the inclusion of 
test translator options in the new operating system. This macro- 
instruction is optional. 



Name 



j. 1 



I Operation 

TESTRAN 



j Operand 
.^ 

PHASES= (phase [ , phase] ) 
rMODE= (NOTRACE V\ 
I (TRACE jj 

[ PAGES=num.ber 3 ] 
[ EXEC=sta t ements ] 

L J. X J 



Operand Field : 

PHASES-phasen 

specifies the test translator components to be included as one or 
both of the following values. 

Value C omponent 

liSiTER The TESTRAN interpreter facility is to be included. 
EDITOR The TESTRAN editor facility is to be included. 

MODE 

specifies the inclusion of the tracing facilities of the test 
translator. TRACE specifies that the tracing facilities are to be 
included. NOTRACE specifies that the tracing facilities are not to 
be included. This parameter is meaningful only if INTER is 
specified in the PHASES parameter. 

PAGES=number 

specifies the maximum number of pages to be produced during one 
execution of the test translator. The value specified must be a 
positive decimal integer smaller than 999. This parameter is 
required if and only if INTER is specified in the PHASES parameter. 

EXEC=statements 

specifies the raaximum number of test translator statements that are 
to be interpreted during one execution of the test translator. The 
value specified roust be a positive decimal integer smaller than 
65535. This parameter is required if and only if INTER is 
specified in the PHASES parameter. 

Example ; The follov/ing example illustrates the use of the TESTRAN 
macro-instruction to specify a test translator with tracing facilities. 
The test translator interpreter is specified. During one execution of 
the test translator the maximum number of pages to be written is 50, and 
the maximum number of test translator statements to be interpreted is 
200. 



I TESTRAN MODE=TRACE,PHASES= INTER, PAGES=50,EXEC=200 

L 
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MACLIB 

The JViACLTB macro-instruction is used to specify the inclusion of the 
macro library (SYSl. MACLIB) in the new operating system. SYSl. MACLIB 
must be allocated space and, if desired, cataloged in the new system 
during the preparation for system generation. This library roust also 
exist as a cataloged partitioned data set (SYSl. MACLIB) in the generat- 
ing system. This macro- instruction is optional. 

If the new system is to contain the E-design-level assembler language 
processor, SYSl. MACLIB must be unblocked. Unblocking is accom.plished by 
allocating space to SYSl. MACLIB during the preparation for system 
generation with a BLKSIZE value of 80 rather than 3360 (see Table 1). 

This macro-instruction may not be used if the volume that contains 
SYSl. MACLIB of the generating system cannot rem.ain mounted throughout 
Stages I and II of system generation. SYSl -MACLIB may be included after 
system generation in the new system with the lEBCOPY utility program. 



r T T 1 

I Name | Operation | Operand | 

j. 1 ^ ^ 

I I MACLIB I [UNIT=name] j 

I I I [VOLNO=serial] | 

L JL X J 



Operand Field : 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the macro library 
being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 

macro library. The value specified must be the same as the value 

given to the VOLUME keyword of the DD statement used to allocate 

space for SYSl. MACLIB during the preparation for system generation. 

Note : If these parameters are omiitted, the macro library is placed on 
the new system residence volume. (If one of these parameters is 
specified, both must be specified.) 

Example : This example illustrates the use of the MACLIB macro- 
instruction to specify the inclusion of the macro library in the 
operating system to be generated. The unit name is 2311. The volume 
serial number is 003475. 



r 1 

j MACLIB UNIT=2311,VOLNO=003a75 j 

L J 
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CHKPOINT 

The CHKPOINT macro-instruction is used to include the checkpoint/ 
restart facility. This macro-instruction is optional. It cannot be 
used if TYPP::=MVT is specified in the CTRLPROG macro-instruction. 



^ ^ ^ ^ 

I Name | Operation | Operand | 

|. _ ^ ^ ^ 

j i CHKPOINT I I 

L .-i. X J 



Operand Field ; The operand field must be left blank. 

Example ; The following example illustrates the use of the CHKPOINT 
macro- instruction to specify checkpoint/restart. 



J. . ^ 

I CHKPOINT I 

L J 
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SORTMERG 

The SORTMERG macro-instruction is used to specify the inclusion of 
sorting and merging functions in the new operating system. Either all 
sojct/raerge functions or selected sort/merge functions can be specified 
for inclusion. However, any function not specified through the SORTMERG 
macro-instruction must not be specified on sort/merge control cards at 
execution time. For example, if the sorting of only fixed length 
records is specified during system generation, the sorting of variable 
length records must not be requested at sort/merge execution time. If 
such sorting were specified, the sort/merge would be terminated because 
the programs for sorting variable length records would not be in the 
generated operating system. This macro-instruction is optional. If it 
is used, the EDITOR and the SORTLIB macro-instructions must also be 
specified. 




Operand 



tSIZE=size] 
[SORTOPT=FULLIB] 



If SORTOPT=FULLIB is not chosen : 

RECTYPE= ( rectype [ , rectype] . . . ) 

SORTDEV=(device[, device] ) 

CNTLFLD= ( cntlf Id [ , cntlf Id] ) 

[MERGE=MERGONLY] 
[]yjESSAGE=(msgopt[,rcsgopt] )] 
[ SORTOPT=MODPRGM] 



Operand Field : 

SIZE=size 

Specifies, as a positive decimal integer, the maximum amount of 
main storage, in bytes, that can be used for sorting. This amount 
of main storage is used only for sorting and does not include the 
space required for data management functions. If this parameter is 
omitted, a value of 12000 is assumed. This parameter can be 
changed at execution time. For further information on this 
parameter refer to the publication IBM System/360 Operating System; 
Sort/Merge , Form C28-6543. 

Note ; The sort/merge program operates in 15500 bytes of main storage. 
Of these 15500 bytes, 12000 (minimum value that can be given to SIZE) 
are used for sorting. The user can specify in the SIZE parameter that a 
larger amount of main storage be used for sorting. The sort/merge 
program issues a variable GETIVIAIN macro-instruction to request storage 
in which to operate. The main storage thus made available to the 
sort/merge program will vary from 12000 bytes to any other amount 
specified by the user in the SIZE parameter. 

The maximum value that can be specified for SIZE is the difference 
between the total amount of main storage available, and the amount 
required for data management routines. The following formula can be 
used to determine the value of SIZE; 

size=A-24N-Y-5000 



80 



N 



Y 



where: 

A 

is the total amount of main storage available for execution. (The 
maxirtiun; amount is the number of bytes of main storage as specified 
in the CENPROCS macro-instruction, miinus the bytes required for the 
nucleus of the operating system minus, if sort/mierge is called by 
another program, the bytes occupied by other programs.) 

is the maximium number of DD statements to be used in any user's 
sort/merge program. 

is a constant with a value of 15 00 which must be entered into the 
formula if any messages are to be written on SYSOUT. Otherwise, 
the value of Y is 0. 

SORTOPT^FULLIB 

specifies that all sort/m^erge functions be included in the user's 
operating system. If this parameter is written, the RECTYPE, 
SORTDEV, CNTLFLD, MERGE, MESSAGE, and SORTOPT=MODPRGM parameters 
must be omiitted. (The values of CONSOLE and ALL are assumed for 
the MESSAGE keyword.) 

RECTYPE^rectypen 

specifies the type and length of records to be sorted oi merged as 
one or more of the following values : 

Value Records 

VAR Variable length records. 

FIXED Fixed length records . 

LONG Records longer than 256 bytes. 

Note ; VAR or FIXED or both must be specified. 

SORTDEV=devicen 

specifies the device (s) to be used for sorting or merging as one or 
more of the following values: 2301, 2311, 2314, 2400. 

Note : The value of 2U00 stands for 2401, 2402, 2403, 2404 and 2415. 

CNTLFLD=cntlfldn 

specifies control field requirement (s) for sorting and/or merging. 
One or both of the following values must be specified: 

Value Control Field 

SINGLE Single control fields 
MULTIPLE Multiple control fields 

MERGE=MERGONLY 

specifies that the merge routines of the sort/merge processor can 
be executed independently from the sort routines for a merging 
application. 
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iyiiiSSAGE=mesgoptn 

specifies the I/O device on which sort/merge messages are to be 
printed, as well as tne type of messages to be produced. If the 
MESSAGE operand is omitted, no messages are printed during a 
sorting or merging operation. The values included in braces { } 
are mutually exclusive- Acceptable values for this operand are: 



Value 



Meaning 



(printer) Sort/merge messages are to be printed on a printer. 
(CONSOLE/ Sort/merge messages are to be printed on a console 

typewriter. 
(all ) All sort/merge messages are to be printed. 
(critical/ Only serious diagnostic sort/merge messages are to be 

printed. 

Note: This param.eter can be changed at execution time. For further 
informiation refer to the puDlication IBM System/360 Operating System: 
Sort/Merge . 



50RT0PT=M0DPRGM 

specifies the inclusion, at 
written modification programs. 



sort/merge execution tim.e, of user- 



Example ; The following example illustrates the use of the SORTMERG 

macro-instruction to specify the use of fixed length records, single 

control fields, and IBM 2311 Disk Storage Drives. The merge functions 

are to be included. The maximum amount of main storage to be used for 
sorting is 12000 bytes. 



r 1 

j SORTMERG RSCTYPE=FIXED, CNTLFLD=S INGLE, SORTDEV=2311, FiERGE=MExRGONLY j 

L J 
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SORTLIB 

The SORTLIB macro- instruction is used to specify the inclusion of the 
sort/merge subroutine library (SYSl. SORTLIB) in the new operating 
system. SYSl. SORTLIB must be allocated space and, if desired, cataloged 
in the new system during the preparation for system generation. This 
library must also exist as a cataloged partitioned data set (SYSl. 
SORTLIB) in the generating system. This macro-instruction is optional. 
If it is used, the SORTMERG macro- instruction m.ust also be specified. 



r T T 1 

I Name | Operation | Operand | 

j. 1 + -I 

I I SORTLIB I [UNIT=naroe] | 

1 I I [VOLNO=serial] | 

L X ± J 



Operand Field ; 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system.. The volume on this device is to contain the sort 
subroutine library being generated. 

VOLNO=serial 

specifies the serial num.ber of the volume that is to contain the 
sort subroutine library. The value specified m.ust be the same as 
the value given to the VOLUME keyword of the DD statement used to 
allocate space for SYSl. SORTLIB during the preparation for system 
generation. 

Note ; If these parameters are omitted, the sort subroutine library is 
placed on the new system residence volume. (If one of these parameters 
is specified, both m.ust be specified.) 

Example ; This example illustrates the use of the SORTLIB macro- 
instruction to specify the inclusion of the sort subroutine library in 
the operating system to be generated. The unit name is 2311. The 
volume serial number is 654321. 



r 1 

1 SORTLIB UNIT=2311,VOLNO=6543 21 | 

L J 
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ALGOL 



The ALGOL macro- instruction i 
ALGOL compiler. This macro-i 
either SCNTF or UNIV must be spe 
keyword of the CENPROCS macro- in 
instruction set is required 
Also, STORAGE=E may not be speci 
If the ALGOL macro-instruction i 
must also be included. 



s used to specify the inclusion of the 
nstruction is optional. If it is used, 
cified as the value of the INSTSET 
struction. (The scientific or universal 
for ALGOL compilations and executions.) 
fied in the CENPROCS macro-instruction, 
s included, the ALGLIB macro- instruction 
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[.SlZE=size] 
'PUNCH= /NODECK) 1 
(DECK /J 

typ£run=^ ( load )1 

\noload/J 

sorcode= ( ebcdic ) ] 

(ISO /J 
SORLIST= /source )] 

\nosource/J 

■PREC1SN= (short)"! 
(LONG /J 



Operand Field : The parameters of the ALGOL macro- instruct ion specify 
the setting of default options at compilation timie. Default options are 
the options that are assumed if the corresponding values of the PARM 
keyword are omitted from an EXEC statement in an ALGOL comipilation. 

SIZE=size 

specifies the default option at compilation time for the maximum 
number of bytes of main storage available to the ALGOL compiler. 
The value specified must be an integer of from 45056 to 999999. If 
this parameter is omitted, a value of 45056 is assumed. 

PUNCH 

specifies the default option at com.pilation time for txhe production 
of a punched deck of the object program. DECK specifies that a 
punched deck is to be produced; NODECK, that a punched deck is not 
to be produced. 

TYPERUN 

specifies the default option at compilation time for the production 
of input to the linkage editor from the program being comipiled. 
LOAD specifies that the program is to be processed by the linkage 
editor after compilation. NOLOAD specifies that the program is 
only to be compiled. 

SORCODE 

specifies the default option at compilation time that indicates the 
character set used to keypunch the source programs to be com.piled. 
EBCDIC specifies the EBCDIC character set. ISO specifies the 
standard 46 character set in BCD established by the International 
Standards Organization (ISO) for ALGOL. 

SORLIST 

specifies the default option at compilation time for the production 
of a listing of the ALGOL source program and identifier table. 
SOURCE specifies that the listing is to be produced; NOSOURCE, that 
the listing is not to be produced. 
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PRECISN 

specifies the default option at compilation time for the internal 
representation of real values. SHORT specifies fullwords. LONG 
specifies doublewords. 

Example ; This example illustrates the use of the ALGOL macro- 
instruction to specify the inclusion of the ALGOL compiler. Unless 
otherwise specified at compilation time the compiler will use 90112 
bytes of main storage and will accept source programs written in the 
standard 46 character set in BCD. Also, a source program listing is to 
be produced, internal real values are to be represented in doublewords, 
and compiled source programs are to be processed by the linkage editor; 
a punched deck is not to be produced. 



I ALGOL SIZE=90112,PRECISN=LONG,SORCODE=ISO 

L 
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ALGLIB 

The ALGLIB macro- instruction is used to specify the inclusion of the 
ALGOL subroutine library (SYSl. ALGLIB) in the new operating system. 
SYSl. ALGLIB must be allocated space and, if desired, cataloged in the 
new system during the preparation for system generation. This macro- 
instruction is optional. 



r T T 1 

I Name | Operation | Operand | 

|. ___+ + ^ 

I I ALGLIB I [UNIT=name] j 

I I I [VOLNO=serial] | 

L J. X J 



Operand Field ; 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the ALGOL 
subroutine library being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 
ALGOL subrC'.itine library. The value specified must be the same as 
the value given to the VOLUME keyword of the DD statement used to 
allocate space for SYSl. ALGLIB during the preparation for system 
generation. 

Note: If these parameters are omitted, the ALGOL subroutine library is 
placed on thB new system residence volum.e. (If one of these parameters 
is specified, both must be specified.) 

Example : This exanole illustrates the use of the ALGLIB macro- 
instruction to specify the inclusion of the ALGOL subroutine library in 
the operating system to be generated. The unit name is 2301. The 
volume serial number is 333777. 



r 1 

I ALGLIB UNIT=2301,VOLNO=333777 | 

L J 
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COBOL 



The COBOL macro-instruction is used to spe 
COBOL compiler. This macro- instruction is opti 
either COMM or UNIV must be specified as 
keyword in the CENPROCS macro-instruction, 
universal instruction set is required for 
executions.) UNIV is required if either float 
used at compilation time, or if exponentiation 
floating point numbers are used at object t 
instruction is included, the COBLIB macro-in 
included. This macro-instruction must be is 
level to be generated. 



cify the inclusion of the 
onal. If it is used, 

the value of the INSTSET 
(The commeTcial or the 

COBOL compilations and 
ing point literals are 
to a non- integer power or 
ime. If the COBOL macro- 
struction must also be 
sued once for each design 



The cataloged procedures for MVT assume the COBOL F compiler. If 
COBOL F is not chosen, the REGION parameter of the cataloged procedures 
should be changed using the lEBUPDTE utility program described in the 
publication IBM System/360 Operating System; Utilities . Region sizes 
are given in the publication IBM System/360 Operating System; Storage 
Estimates . 




I Operation 
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COBOL 



j Operand 

design=(e'I 

rMSGLEV= /FLAGW V] 
L \FLAGE /J 
[LINECNT=lines] 

For COBOL E Only ; 



DATAMAP^ ( DMAP 

(NODMAP 

PROCMAP= J PMAP 

iNOPMAP,_, 

DISPCHK=/ DISPCK Y\ 

(nodispck/J 

[ BUFS IZE=number 3 



Tedit^ (reged )"] 

L (INVED/J 



For COBOL F Only ; 



[SIZE=size] 
[BUF=num.ber] 
■S0RLIST= /SOURCE 






\nosource/J 

STORI^P= ( NOMAP n 
(MAP /J 
PUNCH= /nODECK V] 

\DECK /J -, 

typerun= /load \ 

(NOLO AD /J 
SEQCHK= J SEQ V| 

InoseqX) 
basis=(bas m 

(NOBAS/_ 
[C0PY=/ C0PY \ 

I Inocopy/, 

r ( SPACEi r 

SPACE=.JSPACE2> 

|_ (SPACE3)_ 
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Operand Field : iVlany of the parameters of the COBOL macro-instruction 
specify the setting of default options at compilation time. Default 
options are the options that are assumed if the corresponding values of 
the FARM keyword are omitted from an EXEC statement in a COBOL 
compilation. 

DESIGN 

specifies the design level of the COBOL compiler as either E or F. 

MSGLEV 

specifies the default option at compilation time for the type of 
compilation error messages to be printed. FLAGW specifies that all 
warning and error messages are to be printed. FLAGE specifies that 
warning messages are not to be printed. 

LINECNT=lines 

specifies the default option at compilation time for the number of 
lines to be printed on each page of the COBOL compiler output 
listing. The value specified must be a two-digit integer of from 
10 to 99. If this parameter is omitted, a value of 60 is assumed. 

DATAMAP 

specifies the default option at compilation time for the production 
of a listing of the data-names and their addresses either relative 
to load point for the Working Storage Section or relative to the 
record addresses for the File or Linkage Sections. DMAP specifies 
that a listing is to be produced; NODMAP specifies that the listing 
is not to be produced. 

PROCMAP 

specifies the default option at compilation time for the production 
of a listing of the generated instructions for each statement in 
the Procedure Division. PMAP specifies that the listing is to be 
produced; NOPMAP specifies that the listing is not to be produced. 

DISPCHK 

specifies the default option at compilation time for the generation 
of object code which determines if a field to be displayed exceeds 
the record length of the device on which it is to be written. 
DISPCK specifies that a check is to be made; NODISPCK specifies 
that no check is required. 

BUFSIZE=number 

specifies the default option at compilation time for the size, in 
bytes, of each of the six work buffers used during a COBOL 
compilation. The valid range of values for magnetic tape is 180 to 
32000; for volumes on 2311 Disk Storage drives, 180 to 3600; for 
volumes on 2301 Drum Storage drives, 180 to 20000. (The maximum 
size is an object time option and it is not checked during system 
generation.) If this value is omitted, a value of 180 is assumed. 
The following formula can be used as a guide to determine the 
maximum value that can be specified to optimize the allocation of 
available storage for the data- name table and work buffers- (Any 
remainder should be ignored.) 

number= ]yi-30000- [ (13+L) (N) ] 
6 

where : 

number 

is the size of each work buffer. If the result is less than 
180, 180 must be specified. 
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EDIT 



M 

is the size (in bytes) of main storage. This value should 
correspond to the size specified in the CENPROCS 
macro- instruction. 

L 

is the length of the average data-name. 

N 

is the number of data-names. 

specifies the default option at compilation time for the editing 
function to be used by the compiler. REGED specifies that the 
standard monetary editing function will be used. INVED specifies 
that the inverted monetary editing function will be used. 

SIZE=size 

specifies the default option at compilation time for the number of 
bytes of main storage available to the COBOL F compiler. The value 
specified must be an integer of from 81920 to 9999999. If this 
param.eter is omitted, a value of 81920 is assumed. For further 
information on this parameter, refer to the publication IBM 
Systemi/360 Operating System: COBOL (F) Programmers Guide , Form 
C28-6380. 

BUF=number 

specifies the default option at compilation time for the number of 
bytes of main storage to be used for buffer allocation by the COBOL 
F compiler. The value specified must be an integer of from 2762 to 
99999. This value must be included in the value given to the SIZE 
parameter. If BUF is omitted and SIZE is specified, the value of 
BUF is calculated as: 

SIZE-81920 + 2762 
4 

If both BUF and SIZE are omitted, a value of 2762 is assumed for 
BUF. 

SORLIST 

specifies the aefault option at compilation time for the production 
of a listing of the COBOL source program. SOURCE specifies that 
the listing is to be produced; NOSOURCE specifies that the listing 
is not to be produced. 

STORMAP 

specifies the default option at compilation time for the production 
of a listing of the data-names and their internal attributes in the 
Data Division and the generated instructions for the statements in 
the Procedure Division. MAP specifies that a listing is to be 
produced; NOMAP specifies that a listing is not to be produced. 

PUNCH 

specifies the default option at compilation time for the production 
of a punched deck of the object program- DECK specifies that a 
punched deck is to be produced; NODECK specifies that a punched 
deck is not to be produced. 

TYPERUN 

specifies the default option at compilation time for the production 
of input to the linkage editor from the program being compiled. 
LOAD specifies that the program is to be processed by the linkage 
editor after compilation; NOLOAD, specifies that the program is to 
be compiled only. 
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SEQCHK 

specifies the default option at compilation time for the checking 
of the source program card sequence numbers. SEQ specifies that 
the source program card sequence numbers are to be checked; NOSEQ 
specifies that the source program card sequence numbers are not to 
be checked. 

BASIS 

specifies the default option at compilation time for the possible 
presence of a BASIS card in the source program. BAS specifies that 
a BASIS card may be present in the source program; NOBAS specifies 
that a BASIS card is not present in the source program. (This 
parameter is used to optimize buffer allocation at compilation 
time. ) 

COPY 

specifies the default option at compilation time for the possible 
presence of a COPY and/or INCLUDE clause in the source program. 
COPY specifies that a COPY and/or INCLUDE clause may be present in 
the source program; NOCOPY specifies that neither a COPY nor an 
INCLUDE clause is present in the source program. (This parameter 
is used to optimize buffer allocation at compilation time.) 

SPACE 

specifies the default option at compilation time for the line 
spacing on the listing obtained when the SOURCE and/or MAP options 
are specified. SPACEl specifies single spacing; SPACE2 specifies 
double spacing, and SPACES specifies triple spacing. 

E xample : The following example illustrates the use of the COBOL 
macro- instruction to specify an E- design- level COBOL compiler. The 
number of lines to be printed in each compiler output listing is 55. 
Listings of data-names and their address, and listings of the generated 
instructions for each statement in the Procedure Division are to be 
produced. All warning and error messages are to be printed. The 
generation of object code to determine the length of fields to be 
displayed is not required. The size of each of the six work buffers 
used during a COBOL compilation is 5708- The standard monetary editing 
function will be used. 

The foinnula used to compute the BUFSIZE value is as follows: 

65536-3Q000-[(13-H0) (56)] =57Q8 
6 

where the main storage specified is 6UK, the length of the average 
data-name is 10, and the number of data names is 56. 



r 1 

I COBOL DESIGN=E,LINECNT=55,DISPCHF=NODISPCK,BUFSIZE=5708 | 

L J 
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CQBLIB 

The COBLIB macro-instruction is used to specify the inclusion of the 
COBOL subroutine library (SYS 1 .COBLIB) in the new operating system. 
SYS1. COBLIB must be allocated space and, if desired, cataloged in the 
new system during the preparation for system generation. If the 
E-design-level library is specified, it must also exist as a cataloged 
partitioned data set (SYS 1 .COBLIB) in the generating system. The 
modules for the F-design-level library are generated from SYS1 .MODLIB. 
This macro-instruction is optional. If a combined E and F design level 
subroutine library is required, two COBLIB macro- instructions must be 
issued: one specifying DESIGN=E and one specifying DESIGN=F. 

r T T 1 

I Name | Operation | Operand | 

|. + ^ ^ 

I I COBLIB I DESIGN=|El | 

I I I IF/ I 

I I I [UNIT=name] | 

I I I [VOLNO=serial] | 

L J. J. J 

Operand Field: 

DESIGN 

specifies the design level of the subroutine library as either E or 
F. 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the COBOL 
subroutine library being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 
COBOL subroutine library. The value specified must be the same as 
the value given to the VOLUME keyword of the DD statement used to 
allocate space for SYS 1. COBLIB during the preparation for system 
generation. 

Note: If the UNIT and VOLNO parameters are omitted, the COBOL 
subroutine library is placed on the new system residence volume. 
(However, if one of these parameters is specified, both must be 
specified.) If a combined E- and F-design-level subroutine library is 
to be included and these parameters are specified, they should be 
specified identically in both COBLIB macro-instructions. If they are 
specified differently or they are omitted from one of the macro- 
instructions, the second macro-instruction processed determines where 
the subroutine library is to reside. 

Example ; This example illustrates the use of the COBLIB macro- 
instruction to specify the inclusion of the F-design-level COBOL 
subroutine library in the operating system to be generated. SYS 1. COBLIB 
is to reside on the new system residence volume. 



r 1 

I COBLIB DESIGN=F | 

L J 
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FORTRAN 

The FORTRAN macro-instruction is used to specify the inclusion of the 
FORTRAN compiler- This macro- instruction is optional. If it is used, 
either SCNTF or UNIV must be specified as the value of the INSTSET 
keyword in the CENPROCS macro- instruct ion. (The scientific or the 
universal instruction set is required for FORTRAN compilations and 
executions.) This macro-instruction must be issued once for each design 
level to be generated. 

The cataloged procedures for MVT assume the FORTRAN H compiler. If 
FORTRAN H is not chosen, the REGION parameter of the cataloged 
procedures should be changed using the lEBUPDTE utility program 
described in the publication IBM System/360 Operating System: Utili- 
ties . Region sizes are given in the publication IBM System/360 
Operating System: Storage Estimates . 



j Operation 

-+- 

FORTRAN 




i Operand 
+ 



-H 



DESIGN=iG| 
H 
PUNCH=f NODECK l[ 
'DECK 
SORLIST=f SOURCE H 
iNOSOURCEiJ 
STORMAP= f NOMAP H 
iMAP i] 
OBJPROG= ( LOAD f 
lNOLOAD/_ 
SORCODE= r EBCDICr 
I BCD L 

For FORTRAN E only ; 

LINELNG=length] 
STORAGE= [ SPACE \ 
tpRFRMl. 
SCAN=[ NOADJUST 
t ADJUST 

For FORTRAN E and FORTRAN H only : 

[SIZE=size] 

For FORTRAN G and FORTRAN H only : 

OB JLIST= ( NOLI ST H 
I LIST U 
LINECNT=lines] 
bBJID= j N0ID |1 



For FORTRAN H only : 




OPT= •( 1 

'S0REDIT= ( NOEDIT ) 

. lEDIT 4 

SORXREF= [ NOXREf T 

y XREF I 
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Operand Field ; Many of the parameters of the FORTRAN macro-instruction 
specify the setting of default options at compilation time. Default 
options are the options that are assumed if the corresponding values of 
the FARM keyword are omitted from an EXEC statement in a FORTRAN 
compilation. 

DESIGN 

specifies the design level of the FORTRAN compiler as E, G, or H. 

Note: The FORTRAN H compiler can only operate on a Model 40, or above, 
central processing unit that has at least 256K bytes of main storage. 
(See the CENPROCS macro-instruction.) 

PUNCH 

specifies the default option at compilation time for the production 
of a punched deck of the object program. DECK specifies that a 
punched deck is to be produced; NODECK, that a punched deck is not 
to be produced. 

SORLIST 

specifies the default option at compilation time for the production 
of a listing of the FORTRAN source program. SOURCE specifies that 
the listing is to be produced; NOSOURCE, that the listing is not to 
be produced. 

STORMAP 

specifies the default option at compilation time for the production 
of a map showing the relative location of variables, constants, 
etc., in the source program. MAP specifies that the map is to be 
produced; NOMAP, that the map is not to be produced. 

OBJPROG 

specifies the default option at compilation time for the production 
of input to the linkage editor from the program being compiled. 
LOAD specifies that the source program is to be processed by the 
linkage editor after compilation. NOLOAD specifies that the source 
program is only to be compiled. 

SORCODE 

specifies the default option at compilation time that indicates the 
character set used to keypunch the source programs to be compiled. 
BCD specifies the BCD character set. EBCDIC specifies the EBCDIC 
character- set. 

LINELNG=length 

specifies the default option at compilation time for the maximum 
print line length at object time. At compilation time, if a FORMAT 
statement indicates a record larger than the length specified, a 
warning message is issued. The value specified must be a three- 
digit integer of from 001 to 255. If this parameter is omitted, a 
value of 132 is assumed. 

STORAGE 

specifies the default option at compilation time for the use of 
main storage during a FORTRAN compilation. SPACE specifies that 
15360 bytes of main storage are used for compilations and any 
amount specified in the SIZE keyword in excess of 15360 bytes is 
used for the dictionary, overflow table, and I/O buffers. PRFRM 
specifies that 19456 bytes of main storage are used for compila- 
tions and any amount specified in the SIZE keyword in excess of 
19456 bytes is used for the dictionary, overflow table, and I/O 
buffers. (If PRFRM is specified, blocked input to and output from 
the compiler is allowed.) PRFRM must be specified if TYPE=MVT is 
specified in the CTRLPROG macro-instruction. 
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Note ; If PRFRM is specified, 19456 is the smallest value that can be 
specified in the SIZE keyword. 

SCAN 

specifies the default option at compilation time that indicates 
whether the source program to be compiled is to be prescanned. The 
source program would be prescanned for meaningful blanks, embedded 
blanks, and reserved words and put into a form acceptable to the 
compiler. NOADJUST specifies that the source program is not to be 
scanned. ADJUST specifies that the source program is to be 
scanned. 

SIZE=size (For FORTRAN E) 

specifies the default option at compilation time for the maximum 
number of bytes of main storage available to the FORTRAN E 
compiler. The value specified must be an integer of from 15360 to 
9999999, or it may be of the form nnnnK where nnnn is an integer of 
from 15 to 9999 and K represents 102U bytes. If 9999999 or 9999K 
is specified, all available main storage is to be used by the 
FORTRAN compiler. If this parameter is omitted, a value of 15360 
is assumed. For further information on this parameter, refer to 
the publication IBM Svstem/360 Operating System; FORTRAN IV E 
Programmer's Guide , Form C28-6603. 

SIZE=size (For FORTRAN H) 

specifies the amount of main storage available to the FORTRAN H 
compiler. The value specified must be an integer of from 153600 to 
nnnnnnn, or it may be of the form nnnnK, where nnnn is an integer 
of from 150 to nnnn and K represents 1024 bytes. The values 
nnnnnnn or nnnnK represent the size of the user's problem program 
area. If this parameter is omitted, a value of 204800 is assumed. 
The size specified cannot be changed at compilation time. 

OBJLIST 

specifies the default option at compilation time for the production 
of pseudo- assembly listing of the direct program. LIST specifies 
that the listing is to be produced; NOLIST that the listing is not 
to be produced. 

LINECNT=lines 

specifies the default option at compilation time for the number of 
lines to be printed on each page of the FORTRAN G or H output 
listing. The value specified must be a two-digit integer of from 
01 to 99. If this parameter is omitted, a value of 50 is assumed. 

OBJID 

specifies the default option at compilation time for the assignment 
of internal statement numbers to calls and function references. ID 
specifies that statement numbers are to be assigned; NOID that 
statement numbers are not to be assigned. 

OPT 

specifies the default option at compilation time to optimize the 
execution time of the object modules produced by the FORTRAN H 
compiler. specifies that the object module is not to be 
optimized. 1 specifies that it is to receive full register 
assignment and basic program optimization; 2 that it is to receive 
full register assignment and complete program optimization. 
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SOREDIT 

specifies the default option at compilation time for the production 
of a structured source listing in the data set defined by the 
SYSPRINT DD Statement. This listing indicates the loop structure 
and the logical continuity of the source program. EDIT specifies 
that the listing is to be produced; NOEDIT that the listing is not 
to be produced. 

SORXREF 

specifies the default option at compilation time for the production 
of a cross-reference listing in the data set defined by the 
SYSPRINT DD Statement. XREF specifies that the listing is to be 
produced; NOXREF, that the listing is not to be produced. 

Example : The following example illustrates the use of the FORTRAN 
macro-instruction to specify an E-design- level FORTRAN compiler that 
operates in 20U80 bytes of main storage. Any storage in excess of 15360 
bytes but less than 20U80 bytes is used for the dictionary, overflow 
table, and I/O buffers. The BCD character set is to be the default 
character set option at compilation time. Unless otherwise specified at 
compilation time, a FORTRAN source program listing is to be produced, 
and compiled source programs are to be processed by the linkage editor. 
Also, punched decks and source program maps of variables, constants, 
etc. , are not to be produced. The source program is not to be 
prescanned. A default option of 132 is assumed as the maximum line 
length. 



r 

I FORTRAN DESIGN=E,SIZE=20480,STORAGE=SPACE,SORCODE=BCD 

L 



Specifying the System 95 



FORTLIB 

The FORTLIB macro-instruction is used to specify the inclusion of the 
FORTRAN subroutine library (SYS 1 .FORTLIB) in the new operating system. 
SYS1. FORTLIB must be allocated space and, if desired, cataloged in the 
new system during the preparation for system generation. This library 
must also exist as a cataloged partitioned data set (SYS 1 . FORTLIB) in 
the generating system. This macro-instruction is optional. 

All library members of SYS1. FORTLIB that have a non-IBM name, are 
copied intact into the SYS1. FORTLIB of the new system. All IBM-supplied 
members are copied from SYS1.M0DLIB. 



The graphic subroutine package (GSP) 
through the GRAPHICS macro-instruction. 



for FORTRAN IV is specified 



Only one design level of SYS 1. FORTLIB may be generated during a 
system generation process. The E-design-level library contains subrou- 
tines for programs compiled on the FORTRAN E compiler. The G- and 
H-design-level libraries support programs compiled on any design level 
of the FORTRAN compiler. (The subroutines in SYS 1 .FORTLIB may also be 
used by any operating system program.) If the G- or the H-design-level 
library is to be used by FORTRAN E programs, the FORTRAN E cataloged 
procedures must be modified as described in the publication IBM 
System/360 Operating System; FORTRAN IV E Programmer's Guide , Form 
C28-6603. 



Name 




Operand 



E 
DESIGN=-(G) 

[UNIT=name; 
[VOLNO=serial] 
[UNTABLE=number] 
[OBJERR=unit] 

For G and H Libraries only : 

ONLNRD=unit] 
[ONLNPCH=unit] 

boundry= [ align h 
Inqalign{| 



Operand Field ; 

DESIGN 

specifies the design level of the FORTRAN subroutine library as 
G, or H. 



E, 



UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the FORTRAN 
subroutine library being generated. 

VOLNO=serial 

specifies the serial number of the volume that is to contain the 
FORTRAN subroutine library. The value specified must be the same 
as the value given to the VOLUME keyword of the DD statement used 
to allocate space for SYS 1. FORTLIB during the preparation for 
system generation. 
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Note ; If the UNIT and VOLNO parameters are omitted, the FORTRAN 
subroutine library is placed on the new system residence volume- (If 
one of these parameters is specified, both must be specified.) 

UNTABLE=number 

specifies the number of FORTRAN logical I/O units to be used at 
object time. This number does not necessarily correspond to the 
number of I/O devices in the installation's System/360 Computing 
System. The value specified must be a two-digit integer of from 08 
to 99. If this parameter is omitted, a value of 08 is assumed. 

OBJERR=unit 

specifies which FORTRAN logical I/O unit is to be used for object 
time error messages and FORTRAN dumps. The value specified must be 
a two-digit integer that does not exceed the value given to 
UNTABLE, and cannot be the same as the value given to ONLNRD or to 
ONLNPCH. If the OBJERR parameter is omitted, a value of 06 is 
assumed. 

Note: FORTRAN E cataloged procedures assume logical I/O unit 03 as the 
OBJERR unit. If the value given to the OBJERR parameter is not 03, the 
cataloged procedures must be modified as described in the publication 
IBM System/360 Operating System: FORTRAN IV E Programmer's Guide . (It 
is recommended that when using the E-design-level library, OBJERR=03 be 
specified to avoid the allocation of an additional output device.) 

ONLNRD=unit 

specifies which FORTRAN logical I/O unit is to be used when the 
READ (on-line) statement is encountered in a FORTRAN G or H source 
program. The value specified must be a two-digit integer that does 
not exceed the value given to UNTABLE, and cannot be the same as 
the value given to OBJERR or to ONLNPCH. If the ONLNRD parameter 
is omitted, a value of 05 is assiimed. 

ONLNPCH=unit 

specifies which FORTRAN logical I/O unit is to be used when the 
PUNCH (on-line) statement is encountered in a FORTRAN G or H source 
program. The value specified must be a two-digit integer that does 
not exceed the value given to UNTABLE, and cannot be the same as 
the value given to OBJERR or to ONLNRD. If the ONLNPCH parameter 
is omitted, a value of 07 is assumed. 

Note: FORTRAN G and H cataloged procedures assume logical I/O units 06, 
05, and 07 as the OBJERR, ONLNRD, and ONLNPCH units, respectively. If a 
different value is given to any of those parameters, the cataloged 
procedures must be modified as described in the publications IBM 
System/360 Operating System: FORTRAN IV G Programmer's Guide , Form 
C28-6639, and IBM System/360 Operating System: FORTRAN IV H Program- 
mer's Guide , Form C28-6602. 

BOUNDRY 

specifies the inclusion of the execution time boundary alignment 
routine in SYS1.LINKLIB. ALIGN specifies that the routine is 
provided; NOALIGN that the routine is not provided. 

Example ; The following example illustrates the use of the FORTLIB 
macro- instruction to specify the inclusion of the FORTRAN E subroutine 
library in the operating system to be generated. The unit name is 2301. 
The volume serial number is 333555. Thirty-two logical units are to be 
used by the object time load modules. The third unit is to be used for 
error messages and FORTRAN dumps. 

r : 1 

I FORTLIB UNIT=2301,VOLNO=333555,UNTABLE=32,OBJERR=03,DESIGN=E | 

L J 
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PL1 



The PL1 macro-instruction is used to specify the inclusion of the 
PL/I compiler. This macro-instruction is optional. If it is used, UNIV 
must be specified as the value of the INSTSET keyword in the CENPROCS 
macro- instruction. (The universal instruction set is required for PL/I 
compilations and executions.) The multiple wait option (specified in 
the SUPRVSOR macro-instruction) is required for the execution of PL/I 
object programs that contain WAIT statements with multiple arguments. 
If this macro-instruction is included, the PL 1 LIB macro-instruction must 
also be included. If the PL1 macro-instruction is used during a 
Processor/Library generation, the same SUPRVSOR macro-instruction speci- 
fied for the operating system being modified must also be included. 



Name 



j Operation 

4- 

PL1 




Operand 



DESIGN=F 
PUNCH= r NODECK f] 
t DECK U 
TYPERUN=r LOAD \ 
t NOLOAD I. 
SORCODE= f EBCDIC \ 
iBCD / 
;SIZE=size] 
"OB JLIST= I NOLI ST fl 
ILIST _ U 
f FLAGW 

msglev=]flage 

JFLAGS 
bPT= 



m 



1] 



SORLIST= f SOURCE H 

iNOSOURCEiG 
CHARSET= [ CHAR60 n 

ICHAR48U 
EXTLIST= f NOEXTRE F 

lEXTREF 
ATRLIST= [ NOATR f] 
. lATR U 
REFLIST= [ NOXREF f] 

txREF 
SORMGIN= (m,n) ] 
LINECNT=number] 
CMPTIME= I NOMACRO n 

I MACRO /J 
MACLIST= ( S0URCE2 \\ 

IN0S0URCE2/J 
COMPILE= f COMP \\ 

INOCOMP i^ 
STMDIAG= ( NOSTMT ^ 

t STMT i_ 
bELETE= (item [,item] . . .) ] 



—J 



Operand Field ; Many of the parameters of the PL1 macro-instruction 
specify the setting of default options at compilation time. Default 
options are the options that are assumed if the corresponding values of 
the PARM keyword are omitted from an EXEC statement in a PL/I 
compilation. The DELETE parameter specifies a list of values that 
cannot be used as values of the PARM keyword. 
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DESIGN 

specifies the F design level of the PL/I compiler. 

PUNCH 

specifies the default option at compilation time for the production 
of a punched deck of the object prograir. DECK specifies that a 
punched deck is to be produced. NODECK specifies that a punched 
deck is not to be produced. 

TYPERUN 

specifies the default option at compilation time for the production 
of input to the linkage editor from the program being com.piled. 
LOAD specifies that the programi is to be processed by the linkage 
editor after compilation. NOLOAD specifies that the source program 
is only to be compiled. 

SORCODE 

specifies the default option at compilation time that indicates the 
character set used to keypunch the source programs to be compiled. 
BCD specifies the BCD character set. EBCDIC specifies the EBCDIC 
character set. 

SIZE=size 

specifies the maximum number of bytes of main storage available to 
the PL/I compiler at compilation time. The value specified miust be 
an integer of from 45056 to 999999. If this parameter is omdtted, 
a value of 45056 is assumed. For further information on this 
parameter refer to the publication IBM Svstem/360 Operating System: 
PL/I (F) Programmer's Guide , Form C28-6594. 

OBJLIST 

specifies the default option at compilation time for the production 
of a listing of the object program. LIST specifies that a listing 
is to be produced; NOLIST, that a listing is not to be produced. 

MSGLEV 

specifies the default option at compilation time for the type of 
compilation error messages to be printed. FLAGW specifies that 
warning messages, error messages, and severe error messages are to 
be printed. FLAGE specifies that only error m.essages and severe 
error messages are to be printed. FLAGS specifies that only severe 
error messages are to lae printed. 

OPT 

specifies the default option at com.pilation time to optimize the 
execution time of the object programi produced by the compiler. 1 
specifies that it is to be optimized even at the expense of object 
time storage requirements; that it is to be optimized unless it 
increases object time storage requirements. 

SORLIST 

specifies the default option at compilation time for the production 
of a printed listing of the PL/I source program- SOURCE specifies 
that a listing of the source text is to be produced. NOSOURCE 
specifies that a listing is not to be produced. 

CHARSET 

specifies the number of characters in the character set used to 
write the source program to be compiled. CHAR60 specifies a 
character set with 60 characters- CHAR4 8 specifies a character set 
with 48 characters. 

EXTLIST 

specifies the default option at compilation time for the production 
of a listing of all external data, external entries, and files. 
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EXTREF specifies that a listing is to be produced. NOEXTREF 
specifies that a listing is not to be produced. 

ATRLIST 

specifies the default option at compilation time for the production 
of a listing for each identifier, the identifier with full 
qualification, the statement number declaring the identifier, and a 
list of attributes pertaining to the identifier. ATR specifies 
that a listing is to be produced. NOATR specifies that a listing 
is not to be produced. 

REFLIST 

specifies the default option at compilation time for the production 
of a listing for each identifier, the identifier with full 
qualification, the statement number declaring the identifier and a 
list of all statem.ents in which a reference is made to the 
identifier. XREF specifies that a listing is to be produced. 
NOXREF specifies that a listing is not to be produced. 

SORMGIN=(m,n) 

specifies the default option at compilation time for the margins 
for scanning the source statements. The value m specifies the 
beginning margin and n specifies the end margin. If the source 
statement input to the compiler is from the system input stream 
(i.e., following a DD* statement), the condition 2 > m > n > 100 
must be valid. If the input is not from the system input stream, 
the condition 1 > m > n > 100 must be valid. If this operand is 
omitted, a value of 2 is assumed for m, and a value of 72 is 
assumed for n. 

LINECNT=number 

specifies the default option at compilation time for the maximum 
number of lines to be printed in each page of a PL/I compiler 
output listing. The value specified must be an integer of from 10 
to 99. If this parameter is omitted, a value of 50 is assumed. 

CMPTIME 

specifies the default option at compilation time for the compile- 
time processor. MACRO specifies that compile-time processing is 
required; NOMACRO, that compile-time processing is not required. 

MACLIST 

specifies the default option at compilation time for the listing of 
the input to the compile-time processor. S0URCE2 specifies that a 
listing is to be produced; N0S0URCE2 that the listing is not to be 
produced. 

COMPILE 

specifies the default option at compilation time for compilation to 
proceed after the compile-time processor has been used. COMP 
specifies that compilation is required; NOCOMP, that compilation is 
not required. 

STMDIAG 

specifies the default option at compilation time for the contents 
of diagnostic messages printed during execution of the compiled 
source program. STMT specifies that the messages are to contain 
source program statement nmnbers; NOSTMT specifies that the mes- 
sages are not to contain source program statement numbers. Offsets 
from PL/I entry points are included in the messages in both cases. 
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DELETE=itemn 

specifies that the keyword values or keywords in the value list 
cannot be used at compilation time in the PAJRM field of the EXEC 
statement. The following values can be specified; each has been 
described above. 

DECK FLAGS NOXREF 

NODECK OPT SORMGIN 

LOAD SOURCE LINECNT 

NOLOAD NOSOURCE MACRO 

EBCDIC CHAR60 NOMACRO 

BCD CHAR48 S0URCE2 

SIZE EXTREF N0S0URCE2 

LIST NOEXTREF COMP 

NOLI ST ATR NOCOMP 

FLAGW NOATR STMT 

FLAGE XREF NOSTMT 

Example ; The following exau^ple illustrates the use of the PLl macro- 
instruction to specify an F design-level PL/I compiler that operates in 
5632 bytes of main storage. The compiled source programs are to be 
processed by the linkage editor unless otherwise specified at compila- 
tion time. It is assumed that all warning and error messages are to be 
printed, that the EBCDIC character set is used to punch the source 
programs, that the character set used to write the source programs has 
60 characters, and that the execution time of the object programs is not 
to be optimized. The default options for scanning the source statements 
are 2 and 72, and for the number of lines in each printed page is 50. 
The following keywords, and keyword values cannot be used at compilation 
time in the PARM field of the EXEC statement: CHARU8, BCD, FLAGE, 
FLAGS, OPT, LINECNT, and SORMGIN. It is assumed that, unless otherwise 
specified at compilation time, listings of the source text are to be 
produced; and that a punched deck of the object program, listings of the 
object program, a listing of external data, entries, and files, listings 
of identifiers and their attributes, numbers, qualifications, and 
references are not to be produced. It is also assum.ed that, unless 
specified at compilation time, compile-time processing is not required, 
and that the diagnostic messages are not to contain source program 
statement numbers. 



PLl DESIGN=F, TYPERUN=LOAD , SI ZE=5 632 , 

DELETE= (CHARU8 , BCD, FLAGE , FLAGS, OPT, LINECNT, SORMGIN) 
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PLILIB 

The PLILIB macro-instruction is used to specify the inclusion of the 
PL/I subroutine library (SYSl. PLILIB) in the new operating system. 
SYSl. PLILIB must be allocated space and, if desired, cataloged in the 
new system during the preparation for system generation. This library 
must exist as a cataloged partitioned data set (SYSl. PLILIB) in the 
generating system.. This macro-instruction is optional. 



r T T 1 

I iSIarfie | Operation | Operand | 

|. 1 1 ^ 

I j PLILIB I [UNIT=name] j 

I I I [VOLNO=serial] 

i I I FlIBFCNS^ (REAL \ 

I I i (COMPLEXf 



Operand Field : 

UNIT=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the PL/I 
subroutine library being generated. 

VOLNO-serial 

specifies the serial number of the volume that is to contain the 
PL/I subroutine library. The value specified m.ust be the same as 
the value given to the VOLUME keywora of the DD statement used to 
allocate space for SYSl. PLILIB during the preparation for system 
generation. 

Note : If the UNIT and VOLNO parameters are om.itted, the PL/I subroutine 
library is placed on the new system residence volume. If one of these 
param.eters is specified, both must be specified.) 

LIBFCNS 

specifies the inclusion of complex object time functions in 
SYSl. PLILIB. REAL Specifies that the complex functions are not to 
be included. CO^;PLEX specifies that the complex object time 
functions are to be included. 

Example : The following example illustrates the use of the PLILIB 
macro- instruction to specify the inclusion of the PL/I subroutine 
library in the operating system to be generated. Complex object time 
functions are not to be included. This library is to be placed on the 
new system residence volume. 



r 1 

j PLILIB I 

L J 



102 



RPG 

The RPG macro-instruction is used to specify the inclusion of the 
report program generator (RPG) language processor. This macro- 
instruction is optional. lESRPG and RPG are the name and alias, 
respectively, of the RPG language processor. 



r T r 1 

I Name | Operation | Operand | 

|. + 4 ^ 

I I RPG I I 

L L L J 



Operand Field : The operand field must be left blank. 

Example : The following example illustrates the use of the RPG macro- 
instruction to specify the RPG language processor. 



r 1 

I RPG j 

L J 
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GENERATE 

The GENERATE macro-instruction is used to specify the data sets, 
volumes, and I/O devices required for the system generation process, the 
system generation output options, and the type of generation being done. 

The GENERATE macro-instruction must be the last system generation 
macro- instruction in the user's input deck. The GENERATE macro- 
instruction must immediately be followed by an assembler END statement. 
This macro-instruction is required. 



Name 



I Operation 

■+ 

GENERATE 



Operand 



IR )J 



[( ALL 
GENTYPE=j (NUCLEUS, 
(PROCESSOR 
UT 1 SDS= (SYS 1 . name | x^Ll ) 

UT2SDS= (SYS 1 .name r^Lp 
t,NL/ 
UT3SDS=SYS1.name 
OB JPDS=SYS 1 . name 
RESNAME=name 
RESVOL=serial 
( 2311 
RESTYPE=)2301I 
)2303l 
(2314 
[LNKNAME=name] 
;LNKVOL=serial] 
LBMAINT=E] 
ASMPRT= f QFFn 

Ion 

LEPRT= (option [, option] ) ] 
( CATALOG n 

DIRDATA= ]VT0C [ 
(PDS ) 



Operand Field ; 

GENTYPE 

specifies the type of system generation. (See Table 3 in the 
section "Specifying the System.") This may be one of the following: 



Value 



Generation Type 



ALL 



NUCLEUS 
PROCESSOR 



An operating system is to be generated. 

standard type of generation and is 

GENTYPE keyword is omitted. 

Only a nucleus is to be generated. 

Only language processors and libraries 

generated. 



This is the 
assumed if the 



are to be 



When NUCLEUS is specified, n, a decimal integer of from 1 to 9, 
must also be specified. This identifies the member of the nucleus 
library (SYS 1 . NUCLEUS) that is to contain the nucleus to be 
generated. (The value 1 specifies the member IEANUC01, which is 
the primary nucleus loaded by the normal IPL procedure.) For 
further information, refer to the publication IBM System/360 
Operating System; Operator's Guide , Form C2 8-6 540. 

If NUCLEUS or PROCESSOR is specified, the RESNAME, RESVOL, and 
RESTYPE parameters refer to the system residence volume of the 
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operating system being modified, and the LNKNAME, LNKVOL, and 
LBMAINT parameters refer to the link library of the operating 
system being modified. 

If GENTYPE=ALL, the RESVOL value may not be equal to the serial 
number of the system residence volume of the generating system; and 
the LNKVOL value may not be equal to the serial number of the 
volume that contains the SYS1.LINKLIB of the generating system. If 
sufficient space is available, and if GENTYPE equals NUCLEUS or 
PROCESSOR, members may be added to the libraries of the generating 
system. 

Note ; If a NUCLEUS generation is specified, the same machine configura- 
tion specified for the operating system to be modified must be specified 
in this generation. Also, a previously resident function cannot be made 
transient, because no libraries except SYS1. NUCLEUS are affected by this 
type of generation. However, a previously transient function can be 
made resident. 

UT1SDS 

UT2SDS 

UT3SDS 

specify the names of the sequential data sets to be used during 
system generation by the assembler, linkage editor and utilities. 
These data sets must exist as cataloged data sets in the generating 
system. The data set specified by UT3SDS is used by the linkage 
editor and must reside on a direct-access volume. If the data sets 
specified by UTISDS or UT2SDS reside on magnetic tape, either 
standard labels (SL) or no labels (NL) must be specified. (See 
"Input Deck For System Generation" in the section "Specifying the 
System.") 

OBJPDS=SYS 1 . name 

specifies the name of the partitioned data set to be used for the 
storage of object modules assembled during system generation. This 
data set must exist as a cataloged partitioned data set in the 
generating system. (See "Input Deck for System Generation" in the 
section "Specifying the System.") 

RESNAME=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to become the new system 
residence volume. 

RESVOL=serial 

specifies the serial number of the new system residence volume. 
The value specified must be the same as the value given to the 
VOLUME keyword of the DD statement used to allocate space for 
SYS 1. NUCLEUS during the preparation for system generation. 

RESTYPE 

specifies the unit number of the new system residence device as 
2311, 2301, 2303, or 2314. 

LNKNAME=name 

specifies the unit name of a direct-access device in the generating 
system. The volume on this device is to contain the link library 
being generated. 

LNKVOL=serial 

specifies the serial number of the volume that is to contain the 
link library. The value specified must be the same as the value 
given to the VOLUME keyword of the DD statement used to allocate 
space for SYS1.LINKLIB during the preparation for system 
generation. 
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Note : If LNKNAME and LNKVOL are omitted, the link library is placed on 
the new system residence voliime. (If one of these parameters is 
specified, both must be specified.) 

LBMAINT=E 

specifies that the size of the load modules in the SYS1.LINKLIB and 
SYS1.F0RTLIB being generated is 1024 bytes. The omission of this 
parameter specifies larger load modules. If this parameter is 
omitted, the EU4 linkage editor must be used to maintain the new 
system. 

ASMPRT 

specifies whether assembly listings are to be produced for the 
modules assembled during system generation. ON specifies that 
assembly listings are to be generated; OFF that assembly listings 
are not to be generated. 

LEPRT=optionn 

specifies linkage editor print options as one or two of the 
following values. The values included in braces {} are mutually 
exclusive. 

Value Print Option 

LIST List of control statements in card-image format 

^MAP I Module map 

Cross-reference table (XREF includes the MAP option) 



(xref) 



If this parameter is omitted, only linkage editor error messages, 
if any, are printed. For a more detailed description of these 
options see the publication IBM System/360 Operating System; 
Linkage Editor , Form C28-6538. 

DIRDATA 

specifies the system directory data to be printed during system 
generation as one of the following: 

Value System Directory Data 

CATALOG The catalog of the new system is to be printed. 

VTOC The volume table of contents (VTOC) of each volume in 
the new system is to be printed. The catalog is also to 
be printed. 

PDS The directories of all partitioned data sets in the new 
system are to be printed. The VTOCs and the catalog are 
also to be printed. 

If the DIRDATA parameter is omitted, no system directory data is 
printed . 
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Example : The following example illustrates the use of the GENERATE 
macro-instruction to specify the generation of an operating system. The 
sequential data sets named SYS1.UTIL1, SYS1.UTIL2, and SYS1.UTIL3 will 
be used during system generation by the assembler, linkage editor, and 
utilities. SYS1.UTIL3 resides on a direct-access volume. SYS1. OBJECT 
is the name of the partitioned data set to be used for the storage of 
load modules assembled during system generation. The unit name of the 
new system residence device is 190, the device type is 2311, and the 
serial number of the system residence volume is SYSTEM. Assembly 
listings, linkage editor printed output, and system directory data are 
not to be produced. The link library is to be placed on the system 
residence volume. The size of the load modules in the new SYSI.LINKLIB 
is to be 1024 bytes. 

r ' T 

j GENERATE UT1SDS=SYS1 .UTILI ,UT2SDS=SYS1 .UTIL2 ,UT3SDS=SYS1 .UTIL3, | 
I OB JPDS=SYS 1 . OBJECT , RESNAME= 190, RESTYPE=2 311, RESVOL=SYSTEM , | 

I LBMAINT=E,GENTYPE=ALL | 
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ADDING USER-WRITTEN FUNCTIONS 



The system generation process provides facilities for adding user- 
written functions to the new SYSl. NUCLEUS, SYSl.SVCLIB, and SYSl. 
LINKLIB. These user-written functions must be load modules residing in 
a cataloged partitioned data set in the generating system. That is, the 
user-written function must be compiled, link edited, and placed in a 
cataloged partitioned data set before system generation. (Each load 
module must be a member of the data set) . The name of the partitioned 
data set must be of the fomi SYSl. name. The value of name cannot exceed 
eight alphameric characters, the first of which must be alphabetic. The 
name of the partitioned data set and of the members that contain 
user-written functions are specified with system generation 
macro- instructions . 

The RESMODS macro-instruction specifies load modules to be added to 
SYSl. NUCLEUS. For example. Type 1 and 2 SVC routines. 

The LINKLIB macro- instruction specifies load modules to be added to 
SYSl. LINKLIB. These load modules become members of SYSl. LINKLIB. For 
example, accounting routines. 

The SVCLIB macro-instruction specifies load modules to be added to 
SYSl.SVCLIB. These load modules become members of SYSl.SVCLIB. For 
example. Type 3 and 4 SVC routines and nonstandard label routines. 

If SVCs are added to SYSl. NUCLEUS or SYSl.SVCLIB, the SVCTABLE macro- 
instruction must also be used. This macro-instruction adds an entry to 
the SVC table that specifies the characteristics of each SVC added. 

The RESMODS, LINKLIB, SVCLIB, and SVCTABLE macro- instructions are 
described in the section "Specifying the System." Accounting routines, 
SVCs, and nonstandard label routines are described in the publication 
IBM System/360 Operating System; System Programmer's Guide . 

In the example shown in Figure 13, a user-written function is added 
to the new operating system. In this example, a CSECT is to be added to 
SYSl, NUCLEUS. This CSECT consists of a series of constants that 
describe the nucleus to be generated. During the first step, the CSECT 
is assembled and placed in a temporary data set (DSNAME=SLOADSET) . The 
CSECT is link edited during the second step and the resulting module 
becomes member ID of the SYSl. USER data set. SYSl. USER is a partitioned 
data set residing on volume 333333; it is cataloged in the generating 
system. During system generation, the CSECT will be included in the 
nucleus by the following macro-instruction: 



r ■■ ■ '- 

I RESMODS PDS=SYS1.USER,MEMBERS=ID 

L ., 



For a more detailed description of the control statements required by 
the assembler and linkage editor, refer to the publication IBM System/ 
360 Operating System; Assembler (F) Programmer's Guide , Form C26-3756. 
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I //USER 
I //STEPl 
I//SYSLIB 
j //SYSUTl 
I//SYSUT2 
I //SYSUT3 

|// 

I //SYS PRINT DD 
I//SYSGO 

|// 

I //SYS IN 
I ID 



JOB ]yiSGL£VEL=l 
EXEC PGM=ASMBLR,PARM='NODECK, LOAD, LIST, NOTEST,NOXREF, NORENT* 
DD DSNAME=SYSl.r4ACLIB,DISP=0LD 

UNIT=SYSSQ,SPACE=(1700, (400,50)) 

UNIT=SYSSQ,SPACE=(1700, (400,50) ) 

UNIT=(SYSSQ,SEP=( SYSUTl, SYSUT 2, SYSLIB)), X 

SPACE=(1700, (400,50)) 

SYSOUT=A 

DSNAME=6L0ADSET, UNIT=SYSSQ,SPACE=(80, (200,50)), X 

DISP== (MOD, PASS) 

* 



DD 
DD 
DD 



DD 



DD 
CSECT 
DC C'XXXXXXXXXX- NUCLEUS ID CSECT-XXXXXXXXXX' 

C OPERATING SYSTEM GENERATED — 5/20/67' 

CONNER — DEPT. D5 8' 

C SUPPORTS — FFT-ALL ACCESS METHODS' 

C NUCLEUS— 01' 

C'XXXXXXXXXX- END ID CSECT-XXXXXXXXXX' 



DC 
DC 
DC 

DC 
DC 
END 



I 
|/* 

I //STEP 2 
j //SYSLIN 
j/ZSYSLMOD 
|// 

|// 

I //SYSUTl 

|// 

I//SYSPRINT DD 
|/+ 

|// 

L 

Figure 13. Preparing a User-Written Load Module 



DD 



DD 



EXEC PGM=IEWL,PARM=(XREF,LIST,NCAL) 
DD DSNAME=&LOADSET,DISP= (OLD, DELETE) 

D3NAKE=SYS1.USER(ID) ,UNiT=2311 , DISP= ( ,CATLG) , 

VOLUME= ( , RETA IN . SER= 333333), 

SPACE=(1024, (50,20,5)) 

UNIT= (SYSDA, SEP= (SYSLIN, SYSLMOD) ) , 

SPACE=(1024, (50,20,5)) 

SYSOUT=A 
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OPERATING CONSIDERATIONS 



Operator intervention may be required during the system generation 
process. If the output of Stage I is punched cards, and Stage I has 
been successfully completed, the operator is required to place those 
cards on an input device and to issue a START RDR command for that 
device. 

Operator intervention is also required if system generation is 
performed with only two direct-access devices. During Stage II of a 
two- drive generation, a message is issued to the operator requesting him 
to remove the voluirie that contains SYSl.GENLIB and to mount the volume 
that is to contain the new system. (The MOUNT command must not be 
issued by the operator during a two-drive generation, because it would 
prevent this demounting and mounting of volumes.) 

At start of Stage II the date in the SET DATE command should be 
higher than any expiration date for the system data sets being 
generated. Otherwise the operator must type in "REPLY 00, 'U'" every 
time a data set with a higher expiration date is to be modified. 

The completion of Stage II is indicated by a reader closed message. 
(After Stage II is terminated, system utility programs may be used to 
scratch the data sets indicated by UTISDS, UT2SDS, and UT3SDS.) 

If the new system is to be used in the future as a generating system, 
SYSl.GENLIB and SYSl.MODLXB should be saved. 

It is recommended that a back-up copy of the generated operating 
system be made using the IBCDMPRS utility program. A detailed descrip- 
tion of this program can be found in IBM Svstem/360 Operating System; 
Utilities . 

For maintenance purposes the job stream (SYSPUNCH) and the object 
modules assembled during Stage II (OBJPDS) should be saved after the 
completion of system generation. 

The console sheets produced during system generation should also be 
saved. The IFCOOII message contains information required to reinitial- 
ize the SYSl.LOGREC data set. 

Figure 14 lists sample console sheets for a two-drive and a 
three-drive generation. The lines prefixed with an asterisk indicate 
commands typed by the operator. The asterisks and the comments 
(preceded by . . ) do not appear on the console sheets. These messages 
are explained in detail in the publication IBM Svstem/360 Operating 
System; Operator's Guide . 
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Two-Drive Generation 

IEE007A READY 

* SET DATE=99.360 
START RDR,OOC 
START WTR,OOE 

♦ START 

IEF236I ALLOCATION FOR SYSGEN STEPO initialize new SYSRES 

IEF237I SYSIN ON OOC 
IEF280I K 191, mill, SYSGEN 

IEF233A M 191, DLIB02, SYSGEN mount for GENLIB+MACLIB 

IEF233A M 182 ,SCRTCH, SYSGEN mount for SYSPUNCH 

IEF236I ALLOCATION FOR SYSGEN STEPl Start Stage I 

IEF237I SYSIN ON OOC 
IEF280I K 191, DLIB02, SYSGEN 
// START RDR,182 

lEFlOlI RDR CLOSED end Stage I 

IEF223A M 191 ,DLIB02 , SYSGEN start Stage II 

IEF234A R 191,DLIB02 remove GENLIB+MACLIB 

IEF233A M 191 ,111111 , SYSGEN mount new SYSRES 

IFCOOII D=2311 N=021 F=00070001 L=00070005 3=0007000200 .. SYSl.LOGREC 

IEF280I K 191, mill, SYSGEN save new SYSRES 

IEC202I K 182,1G1001 save job stream 

lEFlOlI RDR CLOSED end Stage II 

IEE007A READY 
^ ^ 

Three-Drive Generation 

IEE007A READY 

SET DATE=99.360 

START RDR, OOC 

START WTR,OOE 

START 

IEF233A M 192 ,111111 , SYSGEN 

IEF236I ALLOCATION FOR SYSGEN STEPO initialize new SYSRES 

IEF237I SYSIN ON OOC 
IEF280I K 192, 111111, SYSGEN 

IEF233A M 192 ,111111, SYSGEN mount new SYSRES 

IEF233A M 191, DLIB02, SYSGEN mount GENLIB+MACLIB 

IEF233A M 182 ,SCRTCH, SYSGEN mount for SYSPUNCH 

IEF236I ALLOCATION FOR SYSGEN STEPl Start Stage I 

IEF237I SYSIN ON OOC 
IEF280I K 192, 111111, SYSGEN 
IEF280I K 191, DLIB02, SYSGEN 
// START RDR, 182 

lEFlOlI RDR CLOSED end Stage I 

IEF233A M 191, DLIBO 2 , SYSGEN start Stage II 

IEF233A M 192, 111111, SYSGEN 

IFCOOII D=2311 N=021 F=00070001 1=00070005 S=0007000200 .. SYSl.LOGREC 

IEF280I K 192, 111111, SYSGEN save new SYSRES 

IEF280I K 191, DLIB02, SYSGEN save GENLIB+MACLIB 

IEC202I K 182,LGL001 save job stream 

lEFlOlI RDR CLOSED end Stage II 

IEE007A READY 

Figure 14. Sample Console Sheets 
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RESTART PROCEDURES 



The system generation process may come to an unsatisfactory comple- 
tion due to errors during Stage I or Stage II. The procedures to 
restart Stage I and Stage II are described below. 

RESTARTING STAGE I 

The most common causes of error during Stage I are: 

• Faulty allocation of the utility data sets for system generation. 

• Key punching errors in the input deck. 

• Contradictory or invalid specifications in the system generation 
macro instructions. 

Faulty allocation of the utility data sets usually causes an 
abnormal-end-of-task (ABEND) termination. Keypunching errors and inval- 
id specifications are indicated with the system generation error 
messages (see Appendix A) printed in the SYSPRINT data set. If any 
errors are found during Stage I, the job stream is not produced. 

Stage I consists of only one job step (execution of the assembler) 
and it must be restarted from the beginning. To restart Stage I follow 
these procedures: 

1. Correct the input deck for system generation. 

2. Scratch and uncatalog the utility data sets (specified by the 
OBJPDS, SYSUT1, SYSUT2, and SYSUT3 DD Statements in the input 
deck) . 



//SCRATCH 


EXEC 


//SYSPRINT 


DD 


//OBJPDS 


DD 


//SYSUT1 


DD 


//SYSUT2 


DD 


//SYSUT3 


DD 


//SYSIN 


DD 



The utility data sets can be scratched and uncataloged by inserting 
the following statements in the input deck for system generation. These 
statements must precede the EXEC PGM=ASMBLR statement of the input deck, 
as shown in Figure 15. 

PGM=IEHPROGM -RESTART DECK- 

SYSOUT=A 

DSNAME=SYS1 .name,DISP= (OLD, DELETE) 

DSNAME=SYS 1 .name,DISP= (OLD, DELETE) 

DSNAME=SYS1 .name,DISP= (OLD, DELETE) 

DSNAME=S YS 1 . name , DISP= (OLD , DELETE) 

DUMMY 

In the preceding statements, the values given to the DSNAME parame- 
ters must be the same as the values given to DSNAME in the corresponding 
DD statements in the input deck for Stage I. These statements represent 
a dummy execution of the lEHPROGM utility program. The utility data 
sets are scratched and uncataloged through the facilities of the job 
control language. Alternatively, the utility data sets can be scratched 
and uncataloged through the SCRATCH and UNCATLG statements of lEHPROGM 
as described in IBM System/360 Operating System: Utilities . 

Figure 15 shows an input deck for restarting Stage I. It is assumed 
that all errors in the input deck have been corrected. The four utility 
data sets are named SYS 1. OBJECT, SYS 1. ONE, SYS 1. TWO, and SYS 1. THREE. 
SYS 1. ONE resides on an unlabeled 9-track magnetic tape volume whose 
serial number is 000167. SYS1. OBJECT, SYS1.TW0, and SYS1. THREE reside 
on 2311 volumes whose serial numbers are SYSTEM, GENVOL, and MODVOL, 
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respectively. The job stream is to be punched by the device designated 
by the SYSCP unit name. 



//SYSGEN 

//SCRATCH 

//SYSPRINT 

//OBJPDS 

//SYSUT 1 

//SYSUT2 

//SYSUT3 

//SYSIN 

//STEP1 

//SYSLIB 

//OBJPDS 

// 

//SYSUT 1 

// 

//SYSUT2 

// 

//SYSUT 3 

// 

//DUMMY 

//SYS PUNCH 

//SYSPRINT 

//SYSIN 



JOB MSGLEVEL=1 -SYSTEM GENERATION- 
EXEC PGM=IEHPROGM -RESTART DECK- 
DD SYSOUT=A 

DD DSNAME=SYS 1 . OBJECT , DISP= (OLD , DELETE) 
DD DSNAME=SYS 1 . ONE , DISP= (OLD , DELETE) 
DD DSNAME=SYS 1 . TWO , DI SP= (OLD , DELETE) 
DD DSNAME=SYS 1 . THREE , DISP= (OLD , DELETE) 
DD DUMMY 

EXEC PGM=ASMBLR -STAGE I INPUT DECK- 
DD DSNAME=SYS 1 . GENLIB , DISP=OLD 
DD DSNAME=SYS1.0BJECT,V0LUME= (, RETAIN ^SER=SYSTEM) 

DISP=(,CATLG) ,UNIT=2311,SPACE= (TRK, (40,20,8)) 
DD DSNAME=SYS1 . ONE, VOLUME= (RETAIN, SER=0 00 1 67) , 

DISP= (,CATLG) ,UNIT=2400,LABEL= (,NL) 
DD DSNAME=SYS 1 . TWO , VOLUME= ( , RETAIN , SER=GENVOL) , 

DISP= (,CATLG) ,UNIT=2311,SPACE= (TRK, (240,20)) 
DD DSNAME=SYS 1 . THREE , VOLUME= ( , RETAIN , SER=MODVOL) , 

DISP= (,CATLG) ,UNIT=231 1 ,SPACE= (TRK, (300,20) ) 
DD VOLUME= (, RETAIN, REF=*. SYSUT 3) ,SPACE= (TRK, (80) ) 
DD UNIT=SYSCP 
DD SYSOUT=A 
DD * 



System Generation macro-instructions 



END 



/* 
// 



Figure 15. Restarting Stage I 



RESTARTING STAGE II 



The most common causes of error during Stage II are: 

• Machine interruptions and noncontinuous machine time. 

• Faulty space allocation of the system data sets during the prepara- 
tion for system generation, especially the primary allocation and 
the directory quantity. 

• Errors in the input deck that cannot be detected during Stage I. 
For example, if SYS1. NUCLEUS was allocated space on volume 111111 
during the preparation of system generation, and if RESVOL=A 1 1 1 1 1 is 
specified in the GENERATE macro-instruction, an error would occur. 

• The job stream is too large for the generating SYS1 .SYSJOBQE. 

• Procedural errors, e.g., volume mounting problems. 

Stage II consists of the execution of the job stream produced during 
Stage I. This job stream is one job that has several job steps. 
Restarting can be accomplished by starting at the beginning of any step 
in the job stream, providing all previous steps have been properly 
executed. Before restarting, some other operations may be required 
depending upon the reason for restarting and the number of steps already 
executed. The following topics describe the job stream, discuss restart 
techniques, give guidelines 



112 



for restarting Stage II, describe the reallocation of data sets, and 
give guidelines for changing the size of SYSl.SYSJOBQE. 

THE JOB STREAM 

If no error messages are printed during Stage I, the job stream is 
produced on the SYSPUNCH data set. The job stream contains one JOB 
statement followed by many EXEC statements (see Figure 16). Each EXEC 
statement is followed by its associated DD statements and other data 
required to execute the assembler, linkage editor, and utility programs 
during Stage II. 

The format of the JOB statement is: 
//SYSGEN JOB 1, "SYSTEM GENERATION" 

The format of the EXEC statement is: 

//SGXX EXEC PGM=program[,COND=condition] [,PARM=value] 

where 

SGXX 

is the step name. XX represents sequential identification numbers 
supplied by the system generation process. The stepname is printed 
in the IEF236I allocation message while the step is being 
initiated. For example, the message 

IEF236I ALLOC. FOR SYSGEN SG7 

indicates that the seventh step is being executed. 

PGM 

indicates the name of the program being executed. The names are 
ASMBLR, lEWL, lEHMOVE , lEBCOPY, lEHIOSUP, IFCDIPOO, and lEHLlST, 
and the programs are executed in this order. As shown in Figure 
16, the assembler (ASMBLR) and the linkage editor (lEWL) are 
executed several times- The first lEWL step builds the new 
SYSl . NUCLEUS . 

The ASSMBLR, lEWL, and lEHMOVE steps have a COND parameter that 
enables them to test whether the previous step was successfully 
completed. If the previous step was unsuccessful, the remaining 
steps are bypassed and Stage II is terminated, 

PARM 

This parameter is supplied for job steps that require PARM 
information. 

During the ASMBLR steps , selected modules are assem.bled and stored in 
the utility data set defined by the OBJPDS DD statement in Stage I. 
These modules and other modules from SYSl.MODLIB are processed during 
the lEWL steps to form load modules. These load modules are placed in 
the new SYSl. NUCLEUS, SYSl.SVCLIB, SYSl.LINKLIB, SYSl.ALGLIB, SYSl. 
COBLIB, SYSl.FORTLIB, and SYSl.TELCMLIB. 

The lEHMOVE utility program copies load modules to the new SYSl. 
SVCLIB, SYSl.LINKLIB, SYSl. COBLIB, SYSl.FORTLIB, SYSl.PLlLIB, and 
SYSl.SORTLIB. 

The IEBCOPY utility program copies SYSl.MACLIB to the new system. 
The IEBCOPY step is produced only if the MACLIB macro instruction was 
specified in Stage I. 
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COND 



GENERATING SYSTEM 










NEW SVSTEM 



Figure 16. The Job Stream 

The lEHIOSUP utility program builds the XCTL tables for type 4 SVCs 
in SYSl.SVCLIB. The IFCDIPQQ utility program initializes SYSl.LOGREC. 
The lEHIOSUP and IFCDIPOO steps are produced only for complete Operating 
System generations. 

The lEHLIST utility program lists the catalog of the new system 
residence volume and any other data specified with the DIRDATA parameter 
of the GENERATE macro instruction. The lEHLlST step is not produced 
during a NUCLEUS generation. 

Figure 17 shows sample job control language statements for each type 
of step in the job stream. The values selected for the parameter result' 
from the specifications in the system generation macro-instructions. In 
Figure 17 , the underlined macro-instruction keywords are used to show 
v/here the value indicated by those keywords is placed. These keywords 
are from the GENERATE macro- instruct ion unless otherwise indicated by a 
comment. Comments (preceded by . . . ) do not appear in the statements. 
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I Assembler 

|. 

//SGXX EXEC PGM=ASMBLR,COND= (4,LT) 

//SYSLIB DD DSNAME=SYS1.GENLIB,DISP= (OLD, PASS) 

// DD DSNAME=SYS1.MACLIB,DISP=0LD,V0LUME= (, RETAIN) 

//SYSUT1 DD DISP=OLD,VOLUME= (, RETAIN) ,LABEL=(,UT1SDS) ,DSNAME=UTlSpS 

//SYSUT2 DD DISP=OLD,VOLUME= (, RETAIN) ,LABEL=(,UT2SDS) ,DSNAME=UT2SDS 

//SYSUT3 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNANE=UT3SDS 

//SYSPRINT DD SYSOUT=A 

//SYSPUNCH DD DISP=OLD,VOLUME= (, RETAIN) , DSNAME=OBJPDS (member) 

//SYSIN DD * 

PRINT ON,NODATA 



Linkage Editor 



//SGXX EXEC PGM=IEWL,PARM='NCAL,XREF,LIST,LET',C0ND=(8,LT) 

//SYSUT1 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAWE=UT3SpS 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DIS P=OLD , UNIT= RESNAI4E , VQLUME=SER =RESVOL , 

// DSNAME=SYS1. name (member) 

//MODLIB DD DISP=0LD,DSNAME=SYS1.M0DLIB,V01UME= (, RETAIN) 

//SYSPUNCH DD DIS P=OLD, VOLUME= (, RETAIN) ,DCB= (,RECFM=F,BLKSIZE=80) , 

// DSNAME =OBJPDS 

//RESLIB DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME=PDS RESMODS macro 

//SYSLIN DD * 
j. 

lEHMOVE 
j. ^ 

//SGXX EXEC PGM=IEHM0VE,PARM=*P0WER=V,C0ND=(8,LT) 

//SYSUT1 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME=UT3SDS 

//SYSPRINT DD SYSOUT=A 

//FROMLIB DD DISP=0LD,DSNAME=SYS1 .MODLIB 

//T0LIB1 DD DISP=OLD,VOLUME= (, RETAIN, SER=RESVgL) , X 

// UNIT =RESNAME 

//T0LIB2 DD DISP=OLD,VOLUME= ( , RETAIN , SER =LMKVOL ) , X 

// UNIT=LNKNAME 

//FRLNK DD DISP=OLD,VOLUME=RETAIN,DSNAME=PDS LINKLIB macro 

//FRSVC DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME =PDS SVCLIB macro 

//SYSIN DD * 



lEHIOSUP 



//SGXX EXEC PGM=IEHIOSUP 

//SYSUT1 DD DSNAME=SYS 1. SVCLIB, DISP= (OLD, KEEP) , 
// UNIT =RESNAME , VOLUME=SER =RESVOL 

//SYSPRINT DD SYSOUT=A 



IFCDIPOO 



//SGXX EXEC PGM=IFCDIPOO,PARM=value 

//SERERDS DD DSNAME=SYS 1 . LOGREC ,UNIT =RESNAME ,DISP= (NEW, KEEP) 

// VOLUME=SER =RESVOL , SPACE= (allocation) 



lEHLIST 



//SGXX EXEC PGM=IEHLIST 

//LINK DD DISP=OLD, VOLUME (, RETAIN, SER =LNKVOL ) , UNIT =LNKNAME 

//SYSRES DD DISP=OLD,VOLUME= (, RETAIN, SER =RESVOL ) , UNIT =RESNAME 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

Figure 17. Sample Steps in the Job Stream 
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RESTART TECHNIQUES 

Stage II can be restarted at the beginning of any job step. If any 
statements in the job stream are to be changed, the job stream must be 
in cards. If no statements are to be changed, the lEBEDIT utility 
program can be used to restart a job stream on tape. Certain operations 
may have to be performed before restarting Stage II. (These operations 
are discussed in the section "Guidelines for Restarting Stage II.") This 
section discusses the techniques used for restarting the job stream 
after any other necessary operations have been performed. The following 
topics describe restarting from cards, punching the job stream, and 
restarting from tape. 

Restarting From Cards 

If the job stream is on cards, a job step can be restarted by placing 
a JOB card ahead of the step's EXEC card. A START RDR command must then 
be issued for the card reader. 

Punching the Job Stream 

If the unit (SYSPUNCH) specified for the job stream during Stage I 
was not a card punch, the lEBPTPCH utility program can be used to punch 
the job stream. lEBPTPCH requires the following statements: 

//PUNCH JOE -PUNCH JOB STREAM- 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD (Parameters of SYSPUNCH DD statement for Stage I) 

//SYSUT2 DD (Parameters designating a card punch) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD * 

PUNCH TYPORG=PS , MAXFLDS= 1 

RECORD FIELD=80 
/* 

where : 

• The parameters of the SYSUTi DD statement must be the same as those 
of the SYSPUNCH DD Statement of Stage I. 

• Sequence numbers can be specified for the punched cards using the 
CDSEQ and CDINCR parameters in the PUNCH utility statement. 

The assembly listing produced (SYSPRINT) at the end of Stage I 
contains a series of PUNCH statements. The operands of these PUNCH 
statements are the cards of the job stream. If a separate listing of 
the job stream is desired, the lEBPTPCH utility program can be used to 
print the job stream. 

Figure 17.1 shows a series of statements that can be used to punch 
the job stream on any 2540 card read punch. The SYSPUNCH DD statement 
in the Stage I input deck was: //SYSPUNCH DD UNIT=182,LABEL= (,NL) 

r 1 

j //PUNCH JOB -PUNCH JOB STREAM- 

|// EXEC PGM=IEBPTPCH 

I //S YSUT 1 DD UNIT= 1 8 2 , LABEL= ( , NL) 

I//SYSUT2 DD UNIT=2540-2 

j //SYSPRINT DD SYSOUT=A 

I //SYS IN DD ♦ 

I PUNCH TYP0RG=PS,MAXFLDS=1 

I RECORD FIELD=80 

|/* 

L 

Figure 17.1 Punching the Job Stream 
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Restarting From Tape 

The lEBEDIT utility program can be used to restart Stage II when the 
job stream is on tape. lEBEDIT should be used to restart from any job 
step after the first. To restart from the first step, issue a START RDR 
command for the tape drive that contains the job stream. 

lEBEDIT can be used to create a new job stream. The new job stream 
contains one of the following arrangements: 

1 . the joD step specified by the user and all the steps that follow 
it; or 

2. only those job steps specified by the user; or 

3. all job steps except those specified by the user. 

lEBEDIT requires the following control statements: 

//RESTART JOB -RESTART STAGE II- 

// EXEC PGM=IEBEDIT 

//SYSPRINT DD SYSOUT=A 

//SYSUTI DD (parameters of SYSPUNCH DD statement for Stage I) 

//SYSUT2 DD UNIT=XXX,LABEL= (,NL) 

//SYSIN DD ♦ 

EDIT START=SYSGEN,STEPNAME=SGXX [,NOPRINT] 

or EDIT START=SYSGEN,TYPE=INCLUDE,STEPNAME= (SGXX [,SGXX] ...) [,NOPRINT] 

or EDIT START=SYSGEN,TYPE=EXCLUDE,STEPNAME= (SGXX[,SGXX] ...) [,NOPRINT] 

/♦ 

where: 

• The parameters of the SYSUTI DD statements must be those of the 
SYSPUNCH DD statement in the input deck for Stage I. 

• The value of the UNIT parameter of the SYSUT2 DD statement is the 
specific unit name (address) of a magnetic tape drive. 

• Only one EDIT statement must be used. 

• If the TYPE parameter is omitted, STEPNAME specifies the first job 
step to be placed in the new job stream. 

• If TYPE=INCLUDE or TYPE=EXCLUDE is specified, STEPNAME specifies the 
job steps to be included or excluded, respectively, from the new job 
stream. Individual job steps and sequences of job steps can be 
specified for inclusion or exclusion. For example: 

STEPNAME= (SG20,SG32-SG37,SG50) 

indicates that steps SG20, SG32 through and including SG37, and SG50 
are to be included or excluded from the operation. 

• NOPRINT must be included if a listing of the new job stream is not 
desired. After the new job stream is created, a START RDR command 
must be issued for the magnetic tape drive designated by the SYSUT2 
DD statement. 

Refer to the publication IBM System/ 360 Operating System: Utilities 
for a more detailed description of lEBEDIT. 

Figure 17.2 shows an lEBEDIT input deck for restarting Stage II. The 
job stream resides on unit 182. The new job stream will reside on unit 
282. All jobsteps after and including SG7 are to be restarted. A 
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listing of the new job stream is not desired- The START RDR command to 
start the new job stream is included with the lEBEDIT deck. The 
appropriate operations described in "Guidelines for Restarting Stage II" 
must have been performed. 

r 1 

I //RESTART JOB -RESTART STAGE II- 

|// EXEC PGM=IEBEDIT 

I//SYSPRINT DD SYSOUT=A 

I //S YSUT 1 DD UNIT= 182, LABEL= ( , NL) 

I//SYSUT2 DD UNIT=282,LABEL= (,NL) 

I//SYSIN DD * 

I EDIT START=SYSGEN,STEPNAME=SG7,N0PRI1S1T 

j/* 

|// START RDR, 282 

L J 

Figure 17.2 Input deck for lEBEDIT 

GUIDELINES FOR RESTARTING STAGE II 

The following topics give guidelines for restarting during Stage II. 
Restarting may require the scratching and reallocation of data sets. 
When this is necessary, reference is made to the section "Reallocating 
Data Sets" for the procedure to be followed. After these operations 
have been performed, the actual restarting of Stage II can be accomp- 
lished by one of the methods described in "Restart Techniques." 

Restarting During Assemblies 

To restart at the beginning of any assembly, place the JOB card in 
front of the EXEC statement of that assembly. If more than one ASMBLR 
step has been executed, and if it is desired to restart at the beginning 
of Stage II (SGI step) , the data set defined by the OBJPDS DD statement 
must be reallocated (see "Reallocating Data Sets") . 

All assemblies must be satisfactorily executed before the link edit 
(lEWL) steps can be executed. 

Restarting Link Edit Steps 

The first lEWL step builds the new SYS1 .NUCLEUS. Subsequent steps 
produce load modules for the new SYS1.SVCLIB, SYS1 .LINKLIB, and, if 
specified for the new system, SYS1.ALGLIB, SYS1.C0BLIB, SYS1.F0RTLIB, 
and SYS1.TELCMLIB. 

If only the first lEWL step was executed, SYS 1. NUCLEUS must be 
reallocated (see "Reallocating Data Sets") before restarting the step. 
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To restart at the beginning of the second lEWL step , any of the 
following libraries that contain system data must be reallocated: 
SySl.SVCLIB, SYSl.LINKLIB, SYSl.ALGLIB, SYSl.COBLIB, SYSl. FORTLIB, and 
SYSl.TELCMLIB. If more than one lEWL step was executed, and if it is 
desired to restart with the first lEWL step, SYSl. NUCLEUS must also be 
reallocated. 

If reallocation is not performed, the space already used in the new 
system libraries is not available, and therefore there may not be enough 
space available for these data sets. This is particularly important for 
those systera data sets that cannot have a secondary allocation. If more 
than sufficient space was allocated to a data set during the preparation 
for system generation, the lEWL step that failed can be restarted 
without reallocation. It is recommended that the reallocations indi- 
cated above be performed when restarting from the beginning of the first 
or second lEWL steps. To restart from the beginning of Stage II, the 
data set defined by the OBJPDS DD statement must also be reallocated. 

Restarting lEHMOVE Step 

The IEHMOVE utility program copies members to the new SYSl.SVCLIB, 
SYSl.LINKLIB, SYSl.COBLIB, SYSl . FORTLIB, SYSl.PLlLIB, and SYSl . SORTLIB. 
No reallocation is needed when restarting this step, unless the step 
failed because there was not enough space in a system data set. Only 
the system, data set that did not have enough space must be reallocated 
(see "Reallocating Data Sets"), because any member that existed in the 
new system data set will not be moved into it again when the step is 
restarted. 

If the data set that did not have enough space was SYSl.SVCLIB, 
SYSl.LINKLIB, SYSl.COBLIB, or SYSl. FORTLIB, one of the two following 
procedures must be performed. 

• Follow the procedures for restarting with the second lEWL step as 
described in "Restarting Link Edit Steps," or 

• Copy the data set to a scratch volume using the lEBCOPY utility 
program. Scratch and uncatalog the space for the data set on its 
original volume with lEHPROGM. Allocate and catalog the required 
space for the data set on its original volume. Use lEBCOPY to copy 
the data set from the scratch volume to its original volume. 
Restart Stage II at the beginning of the IEHMOVE step. 

Restarting lEBCOPY Step 

This step copies SYSl.MACLIB to the new system. To restart at the 
beginning of this step, the new SYSl.MACLIB must be reallocated (see 
"Reallocating Data Sets"). To restart at any preceding step, follow the 
instructions in the preceding topics . 

Restarting lEHIOSUP, IFCDIPOO, and lEHLIST 

These three steps can be executed in any order. lEHIOSUP and lEHLIST 
can be restarted any number of times without need of reallocation of 
system data sets. Before restarting IFCDIPOO, the DISP= (NEW,KEEP) 
parameter of its DD statement for SYSl.LOGREC must be changed to 
DISP= (OLD, KEEP) , or SYSl.LOGREC must be scratched (the IFCDIPOO step 
does its own allocation for SYSl.LOGREC). 

The ASMBLR, lEWL, lEHMOVE, and lEBCOPY stepB must have been executed 
without error before the lEHIOSUP step is executed. 
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REALLOCATING DATA SETS 

Reallocating data sets includes the following operations: 

• Scratching and uncataloging the space allocated to the data set 
during the preparation for system generation. 

• Allocating new space to the data set and cataloging it. 

The following topics discuss the reallocation of the utility data set 
defined by the OBJPDS DD statement during Stage I, reallocating new 
system data sets using the same amount of space, and reallocating system 
data sets using more space. 

The reallocations described in this section may alter the order in 
which the new system data sets were originally allocated. If this order 
is important, the lEHMOVE utility program can be used after system 
generation to rearrange the new system data sets. 

Reallocation of OBJPDS 

Use the following statements to reallocate the utility data set 
specified by the OBJPDS DD statement during Stage I. 

PGM=IEHPROG]y! -SCRATCH OBJPDS- 

DSNAME=SYS1 . name , DISP= (OLD, DELETE) 

SYSOUT=A 

DUMMY 

PGf^IEHPROGM - REALLOCATE OBJPDS- 

(Parameters for OBJPDS in Stage I input deck) 

SYSOUT=A 

DUMMY 

In the preceding statements: 

• The DSNAME parameter of the first OBJPDS DD statement must contain 
the name given to the utility data set in the input deck to Stage I. 

• The second OBJPDS DD statement must contain the same parameters that 
it contains in the Stage I input deck. 

Reallocating on the Same Space 

The input deck for scratching and reallocating space to the new 
system data sets must contain the following statements. The statements 
must be in the order shown. 

1. JOB statement. 

2. EXEC statement with the PGM=IEHPROGM parameter. 

3. A SYSPRINT DD Statement defining the system output unit- 

4. A DD statement defining the unit and serial number of the 
generating system residence volume: 

//GENRES DD UNIT=unit,VOLUME=SER=serial,DISP=OLD 

5. A DD Statement defining any other permanent volume on which data 
sets to be reallocated reside: 

//ddname DD UNIT=unit,VOLUME=SER=serial,DISP=OLD 
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//OBJPDS 


JOB 


//STEPl 


EXEC 


//OBJPDS 


DD 


//SYSPRINT 


DD 


//SYSIN 


DD 


//STEP2 


EXEC 


//OBJPDS 


DD 


//SYSPRINT 


DD 


//SYSIN 


DD 


// 





6. A DD Statement for each type of removable device on which data sets 
to be reallocated reside: 

//ddname DD ONIT= (unit, , DEFER) ,VOLUME=PRIVATE,DISP=OLD 

7. A DD * statement (SYSIN). 

8. A SCRATCH and an UNCATLG statement for each new system data set to 
be reallocated. The SCRATCH and UNCATLG statements must have the 
following format: 

SCRATCH DSNAME=dsname, VOL=device=s erial , PURGE 
UNCATLG DSNAME=dsname, CVOL=device=serial 

where CVOL designates the new system residence volume. 

9. A /* statement. 

10. EXEC statement with the PGM=IEHPROGM parameter. 

11. A GENRES DD statement (described above). 

12. A DD statement for each permanent device (described above). 

13. A DD statement for each type of removable device (described above). 

14. A SYSPRINT DD Statement defining the system output unit. 

15. A DD statement for each of the new system data sets to be 
reallocated. This DD statement must be the same used in the input 
deck for the preparation for system generation. 

16. A DD * statement (SYSIN). 

17. A CATLG statement for each new system data set to be reallocated. 
The CATLG statement must be the same used in the input deck for the 
preparation for system generation. 

18. A /* statement. 

For example, SYSl.SVCLIB and SYSl.LINKLIB must be reallocated. The 
following DD statements defined these two libraries during the prepara- 
tion for system generation: 

//SVCLIB DD DSNAME=SYS1. SVCLIB,VOLUME=(, RETAIN, SER= AAAlll ) , X 

// DNIT=2301,DISP=(,KEEP) ,SPACE=(TRK, (40,,75),,CONTIG), X 

// LABEL=EXPDT=99350,DCB= (DSORG=POU,RECFM=U,BLKSIZE=1024) 

//LINKLIB DD DSNAiyiE=SYSl. LINKLIB,VOLUME= (, RETAIN, SER=AAA112) , X 
// UNIT=2311, DISP=(, KEEP) ,SPACE=(TRK, (1250,, 100) ,,CONTIG) , X 

// LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

The generating system residence volume is a 2311 volume whose serial 
number is 111111. Figure 18 shows the input deck for this reallocation. 
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I //SAME JOB 
I //STEPl EXEC 
I //GENPES DD 
I //NEWRES DD 
I //LINVOL DD 
j//SySPRINT DD 
I //SYS IN DD 
I SCRATCH 
I UNCATLG 
I SCRATCH 
I UNCATLG 
|/* 

|//STEP2 
j //GENRES 
I //NEWRES 
I //LINVOL 
|//SYSPRINT DD 
I //SVCLIB DD 
|// 
|// 
J//LINKLIB 

|// 
|// 

|// 

I//SYSIN 

j CATLG 
I CATLG 
j/* 

|// 

L 

Figure 18. Rea 



EXEC 
DD 
DD 
DD 



DD 



DD 



-REALLOCATE ON SAME SPACE- 
PGM=IEHPROGM -SCRATCH- 

UNIT=2 311 , VOLUjyiE=SER=llllll , DISP=OLD 
UNIT=2301,VOLU]yiE=SER=AAAlll,DISP=OLD 
UNIT=(2311, , DEFER) , VOLUiy!E=PRIVATE,DISP=OLD 
SYSOUT=A 
* 

DSNAME=SYS1. SVCLIB, VOL=2301=AAA111 
DSNA]yiE=SYSl. SVCLIB, CVOL=2301=AAA111 
DSNAME=SYS1.LINKLIB,V0L=2311=AAA112 
DSNAME=SYS1.LINKLIB,CVOL=2301=AAA111 

PGM=IEHPROGM -ALLOCATE- 

UNIT=2 311 , V0LUME=SER=111111 , DISP=OLD 

UNIT=2301,VOLUiME=SER=AAAlll,DISP=OLD 

UNIT=(2311, , DEFER) , VOLUME= PRIVATE, DISP=OLD 

SYSOUT=A 

DSNAjyiE=SYSl. SVCLIB, VOLUME= (, RETAIN, SER=AAA111) , X 

UNIT=2301,DISP=( ,KEEP) ,SPACE=(TRK, (40, ,75) , ,CONTIG) , X 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=102U,DSORG=POU) 

DSNAME=SYS1. LINKLIB,VOLUME=( , RETAIN, SER=AAA112) , X 

UNIT=2311,DISP=(,KEEP) , X 

SPACE=(TRK, (1250, ,100) , ,CONTIG) , LABEL=EXPDT=99350 , X 

DCB=(RECFM=U,BLKSIZE=3625) 

* 

DSNAME=SYS1. SVCLIB, CVOL=2301=AAA111,VOL=2301=AAA111 

DSNA^3E=SYS1. LINKLIB, CVOL=2301=AAA111, V0L=2311=AAA112 
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Reallocating With More Space 

The method for reallocating with more space depends on whether the 
space for the data set must be contiguous. If the data set need not be 
contiguous, follow the procedure described in "Reallocating on the Same 
Space" changing the SPACE parameter of the DD statement (statement 15) 
for the new system data set in the second step. This same procedure can 
be followed for a contiguous data set if there is enough contiguous 
space for the new allocation elsewhere on the volume. 

The second case can best be illustrated with the following example, 
one of the new system volumes is organized as shown in Figure 19. 




Figure 19. Reallocation on Same Volume 
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Enough space was not allocated for SYSl.LINKLIB and there is not 
enough contiguous space after SYSI.PLILIB for a new allocation of 
SYSl.LINKLIB. One of two procedures can be followed to free space for 
the new allocation for SYSl.LINKLIB. 

1. If there is no system data in SYSl.LINKLIB, SYSl.FORTLIB, and 
SYSI.PLILIB, follow the procedures described in "Reallocating in 
the Same Space" to reallocate SYSl.LINKLIB, SYSl.FORTLIB, and 
SYSI.PLILIB. Correct the SPACE parameter in the DD statement for 
SYSl.LINKLIB. 

2. If there is system data in SYSl.LINKLIB, SYSl.FORTLIB, or SYSl. 
PLILIB follow these procedures: 

a. Copy the library that contains system data onto a scratch 
volume using the lEBCOPY utility program. 

b. Follow the procedures described in "Reallocating in the Same 
Space" to scratch SYSl.LINKLIB, SYSl.FORTLIB, and SYSI.PLILIB, 
correcting the SPACE parameter in the DD statement for 
SYSl.LINKLIB. 

c. Copy the library that contains system data from the scratch 
volume to its original volume. 

If a system data set (contiguous or not) contains system data, and if 
there is enough space elsewhere in the volume, the following procedure 
can be used: 

1. Rename the system data set. 

2. Allocate and catalog space for the system data set (with its 
correct name) on the same volume. 

3. Copy the data in the renamed data set onto the newly allocated data 
set. 

U. Scratch and uncatalog the renamed data set. 

Figure 20 is an example of reallocation on the same volume of a 
system data set that contains system data. The system data set to be 
reallocated is SYSl.LINKLIB. It was allocated space during the prepara- 
tion for system generation with the following DD statement: 

//LINKLIB DD DSNAME=SYS1. LINKLIB,VOLUME= (, RETAIN, SER=LINVOL) , X 
// UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (500, ,50) ,,CONTIG) , X 

// LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

The new system residence volume is a 2301 volume whose serial number 
is SYSTEM. The renamed SYSl.LINKLIB will be called SYSl. HARRY. The 
generating system residence volume is a 2311 volume whose serial number 
is mill. 



Restart Procedures 121 



//MOVE JOB 

//STEPl EXEC PGM=IEHP.ROG]yi 

//SYSPRINT DD SYSOUT=A 



-REALLOCATE WITH DATA- 
- RENAME- 



//GENRES 


DD 


//NEWRES 


DD 


//LINVOL 


DD 


//SYSIN 


DD 


RENAME 



UNCATLG 

CATLG 
/* 

//STEP 2 EXEC PGM=IEHPROGM, 
//SYSPRINT DD SYSOUT=A 



UNIT=2311,VOLUME=SER=llllll,DISP=OLD 

UNIT=2301,VOLUME=SER=SYSTEM,DISP=OLD 

UNIT= (2311, , DEFER) ,VOLUME=PRIVATE,DISP=OLD 

* 

DSNA^]E=SYSl.LINKLIB,VOL=2311=LINVOL, 

NEWNAME=SYS1 . HARRY 

DSNAME=SYS1.LINKLIB,CVOL=2301=SYSTEM 

DSNAME=SYS1. HARRY, CVOL=2301=SYSTEM,VOL=2311=LINVOL 



-REALLOCATE - 



DD 
DD 
DD 
DD 



DD 



//GENRES 

//NEWRES 

//LINVOL 

//LINKLIB 

// 

// 

// 

//SYSIN 

CATLG 
/* 

//STEP3 EXEC PGM=IEBCOPY 
//SYSPRINT DD SYSOUT=A 
//SYSUTl DD 
// 

//SYSUT2 DD 
// 
//SYSIN DD 



UNIT=2311,VOLUME=SER=llllll,DISP=OLD 

UNIT=2301,VOLUME=SER=SYSTEM,DISP=OLD 

UNIT= ( 2311, , DEFER) , VOLUME=PRIVATE,DISP=OLD 

DSNAME=SYSl. LINKLIB, VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) , 

SPACE=(TRK, (1200,, 100) , ,C0NTIG) , LABEL=EXPDT-99350, 

DCB=(RECFM=U,BLKSIZE=3625) , 

DSNAME=SYS1. LINKLIB, CVOL=2301=SYSTEM, VOL=2311=LINVOL 



-COPY- 



//STEP4 EXEC PGM=IEHPROGM 
//SYSPRINT DD SYSOUT=A 



DSNAME=SYS1 . HARRY, VOLUME=SER=LINVOL, UNIT=2311, 

DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1 . LINKLIB , VOLUME=SER=LINVOL, UNIT=2 311 , 

DCB=(RECFM=U,BLKSIZE=3625) 

DUMMY 

-SCRATCH- 



//GENRES DD 
//NEWRES DD 
//LINVOL DD 
//SYSIN DD 
SCRATCH 
UNCATLG 
/* 
// 



UNIT=2311,VOLUME=SER=llllll,DISP=OLD 

UNIT=2301,VOLUME=SER=SYSTEM,DISP=OLD 

UNIT=(2311, ,DEFER) ,VOLUME=PRIVATE,DISP=OLD 

* 

DSNAME=SYS1. HARRY, VOL=2311=LINVOL 

DSNAME=SYS1 . HARRY ,V0L=2 3 01= SYSTEM 



Figure 20. Reallocate Data Set With System Data 



REALLOCATING SYSl . SYSJOBQE 

If the job stream is too large for the SYSl . SYSJOBQE of the 
generating system one of the following procedures can be followed: 

• Converting the job stream into two or more jobs 

• Enlarging SYSl. SYSJOBQE 

The job stream can be converted into two or more jobs by placing 
additional JOB cards throughout the job stream. For example, inserting 
a JOB card in front of the first lEWL step. This method requires that 
the job stream be in cards . 

The size of SYSl . SYSJOBQE can be changed following this procedure: 

1. Determine the appropriate size of SYSl. SYSJOBQE using the formula 
given in the publication IBM Svstem/360 Operating System: Storage 
Estimates. 
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2. Run the following job: 



//LAST JOB JOB 
//STEP EXEC 
//DUMMY DD 
// 

//GENRES DD 

//SYSPRINT DD 

//SYSIN DD 

SCRATCH 

UNCATLG 

RENAME 



/♦ 
// 



CATLG 



PGM=IEHPROGM 

DSNAME=SYS1. DUMMY, VOLUME= (, RETAIN, SER=serial) , 

UNIT=unit,DISP=(, CATLG) ,SPACE=(TRK, (xxx) ,,CONTIG) 

UNIT=unit,VOLUME=SER=serial,DISP=OLD 

SYSOUT=A 

♦ 

DSNAME=SYS 1 . SYSJOBQE , VOL=unit=serial 

DSNAME=SYS 1 . SYSJOBQE 

DSNAME=SYS 1 . DUMMY ,VOL=unit=serial , 

NEWNAME=SYS 1 . SYSJOBQE 

DSNAME=SYS 1 . SYSJOBQE ,VOL=unit=serial 



In the preceding statements, 

• SYS 1. DUMMY is allocated space on the same volume on which the 
generating SYS 1 . SYS JOBQE resides. The amount of space allo- 
cated for SYS 1. DUMMY must be the appropriate size for 
SYS 1. SYS JOBQE. 

• The GENRES DD statement defines the generating system residence 
volume . 

• The UNCATLG and CATLG statements should be omitted if SYS1. 
SYSJOBQE is not cataloged in the generating system. 

• The VOL parameter of the utility statements defines the volume 
on which SYS 1 .SYSJOBQE resides. 

3. Stop the system and restart (IPL again) . 
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TESTING THE NEW SYSTEM 



This section describes the sample programs provided by IBM to test 
the functioning of various components of the new system after system 
generation. The sample programs are contained in SYS1.SAMPLIB of the 
starter operating system package. Appendix E of this publication 
describes the procedure used to punch sample program cards from 
SYS1 .SAMPLIB. These card decks can then be used whenever an operating 
system component is to be tested. 

The following list shows the names of the sample programs provided in 
SYS1.SAMPLIB and the components they test: 

Program Component 

lEXSAMP ALGOL 

lETESP Asembler E and F 

lEPSAMP COBOL E 

lEQSAMP COBOL F 

lEJESP FORTRAN E 

lEYSP FORTRAN G and H 

SAMP2250 Graphics - 2250 Display Units 

SAMP2260 Graphics - 2260 Display Stations 

GSPSAMP Graphic Subroutine Package for FORTRAN IV 

IEMSP2 PL/ I F 

RPGSMPL RPG 

lERSP Sort/merge 

IHGSAMP Update Analysis Program 

Each of the following pages contains the description of a sample 
program, operating instructions, and a description of the program 
execution results. More detailed operating instructions can be found in 
the publication IBM System/360 Operating System: Operator's Guide . 

Note : The DD statements of the sample programs specify UNIT=2311. If 
the system data sets affected by the sample program do not reside on a 
2311, the UNIT parameter should be changed accordingly. If the system 
data set is cataloged, the UNIT parameter of the corresponding DD 
statement can be deleted rather than changed. 
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ALGOL SAMPLE PROGRAM (IEXSAi4P) 

The lEXSAMP card deck (punched from SYSl.SAMPLIB) consists of: 

1. Job control language statements for an ALGOL compilation, a linkage 
edit, and execution. 

2. ALGOL sample program source statements. 

The sample program generates the first twenty lines of Pascal's 
Triangle. Comments includea in the program may be used for checking the 
results. (The sample prograrfi is included as example 3 in IBM System/360 
Operating System; ALGOl, Language , Form C28-6615.) 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the lEXSAMP card deck in the card reader, ready the reader, 
and press the End of File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

The normal output from the compiler will be: 

1. A list of all job control language statements that apply to the 
compiler. 

2. A list of all source statements supplemented by a count of the 
semicolons occurring in the program. 

3. The identifier table in symbolic form, giving details of all 
identifiers used in the program. 

4. Information on main storage reguirements at execution time. 
The normal output from, the linkage editor will be: 

1. A list of all job control language statements which apply to the 
linkage editor. 

2. A cross-reference table of the load module. 
The normal output at execution time will be: 

1. A list of all job control language statements which apply to the 
execution. 

2. The first twenty lines of Pascal's triangle, corresponding to the 
comments included in the source statements. 

A more detailed description of the system output is contained in IBM 
System/360 Operating System; ALGOL Programmer's Guide , Form C33-4000. 
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ASSEMBLER E & F SAMPLE PROGRAM (lETESP) 

The lETESP card deck (punched from SYSl.SAMPLIB) is the sample 
program source deck. 

The sample problem demonstrates the use of the assembler and serves 
as a minimal test of the functioning of the assembler. In addition, it 
provides sample coding that demonstrate the definition and use of user 
written macro-instructions, the calling of system macro- instructions, 
and the proper method of saving and restoring registers upon entry and 
exit from a problem program. 

The input is assembled into the program in the form of a TABLE and a 
LIST of entries which are to be passed against the table. Each item in 
the table contains an argument name such as ALPHA and space in which 
information concerning that name is to be placed. Each entry in the 
LIST contains an argument name and function values. The formats of the 
TABLE entries and the LIST entries are different, and both formats are 
described by means of DSECTs . The program searches the TABLE for an 
argument name in the list. If a match is found, the function values are 
reformatted and moved to the appropriate TABLE entry. If an argument 
name in thti LIST cannot be found in the TABLE, a switch is set in the 
LIST entry. After all LIST entries have been processed, both the LIST 
and TABLE areas are compared with TESTTABL which contains the predefined 
results. If the comparison is equal, the routine executed properly and 
a message is written to indicate this. 

Use of the program for Assembler E may be achieved by calling the IBM 
supplied cataloged procedure ASMECLG in the following manner: 

//jobnam^ JOB 

//stepname EXEC PROC=ASMECLG 

//ASM. SYS IN DD * 

Sample Program Source Deck 

/* 

The program for Assembler F may be called by substituting the 
following execute card in the above deck: 

//stepname EXE^ PROC=ASMFCLG 

This procedure calls for an assembly, link edit, and execution of the 
sample program. A more detailed explanation of the contents of the 
procedure and use of the assembly program is given in IBM System/360 
Operating System; Assembler (E) Programmers Guide , Form C28-6595 and in 
IBM System/360 Operating System: Assembler (F) ProgramiTiers Guide , Form 
C26-3756. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the sample program source deck in card reader, ready reader, 
and press the End of File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

The check for the successful execution of the sample program is a 
message on the operator's console. The message says either, "ASSEMBLER 
SAMPLE PROGRAM SUCCESSFUL" or "ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL." 
The program gives a normal return to the operating system with a return 
code of zero. 
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COBOL E SAMPI.E PROGRAM (lEPSAMP) 

The IEPSAMP card deck (punched froiri SYSl.SAMPLIB) consists of: 

1. Job control language statements to execute the COBOL E cataloged 
procedure COBECLG to compile, link edit, and execute. 

2. COBOL sample program source statements. 

3. DD statements for tape data sets required at execution time. 

The sample program tests the COBOL compiler's ability to WRITE to and 
READ from tape, checking proper data alignment where data is a mixture 
of DISPLAY COMPUTATIONAL and COMPUTATIONAL- 3. 

The verbs exercised in this program are OPEN, CLOSE, READ, WRITE, 
PERFORM, IF, MOVE, GO TO, DISPLAY, ADD. There are 575 source 
statements. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Mount unlabeled tapes on 182, 183, and 282. 

3. Set the load address switches and press the Initial Irogram Load 
key to load the operating system. 

4. Place the IEPSAMP card deck in the card reader, ready reader, " and 
press End of File key. 

5. Ready the printer. 

6. Execute the job. 
OUTPUT 

1. The scheduler will read, process, and print (on the device 
specified as SYSOUT by the operator) all job control language 
statements . 

2. The compiler will read and list the source program on the device 
specified as SYSOUT by the operator. 

3. The compiler will prepare and list (on SYSOUT) 

a. Heading including date and level 

b. The source program 

c. A data map of the Data Division 

d. An object code listing (PMAP) of the Procedure Division 

U. The linkage editor will prepare and list (on SYSOUT). 

a. A module map 

b. A cross-reference list 

5. The COBOL load module will list (on SYSOUT) the following: 

GROUP B LEVEL P TEST CASE 1 
END OF PROGRAM 
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COBOL F SAMPLE PROGRAM (lEJSP) 

The lEQSAMP card deck (punched from SYSl. SAMPLIB) consists of 

1- Job control language to call a cataloged procedure to compile, 
linkage edit, and execute the sample program. 

2. COBOL sample program source statements. 

The sample program tests the operation of the COBOL F com.piler; it 
generates an output data set on tape and then reads, processes, and 
exhibits this data set. The program uses the COBOL verbs, IF, OPEN, 
READ, WRITE, CLOSE, DISPLAY, MOVE, ADD, STOP, GO TO, PERFORM, NOTE, 
TRACE, and EXHIBIT. A complete output listing of the program may be 
found in the publication IBM System/360 Operating System; COBOL (F) 
Proqramraer' s Guide , Form C28-6380- 

OPERATING INSTRUCTIONS 

1. Mount the operating system. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the lEQSAMP deck in the card reader, ready reader, and press 
End of File key. 

4. Ready the printer. 

5. Execute the job. 
OUTPUT 

1. Listing of all job control language statements. 

2. Listing of the source program. 

3. Listing of 

a. heading including date and level 

b. source program 

c. data map of the Data Division 

d. object code listing of Procedure Division 

4. Module map and cross-reference list. 
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FORTRAN E SAMPLE PROGRAM (lEJSP) 

The lEJESP card deck (punched from SYSl.SAMPLIB) consists of: 

1. Job control language statements for a FORTRAN E compilation. 

2. FORTRAN sample program source statements. 

3 . Job control language statements for a link edit and execution of 
the sample program. 

4. Data deck for FORTRAN sample program execution. 

The sample program is a simultaneous equations routine which consists 
of 104 FORTRAN source statements: 

1 Specification 

14 Format 

17 Read/Write 

27 Control 

16 Arithmetic 

29 Comments 

The program processes eight data cards as its input. The comments 
cards show a complete list of the expected output from the execution of 
the program. This list may be used for checking output. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the lEJESP card deck in the card reader, ready reader, and 
press the End of File key. 

4. Ready the printer. 

5. Execute the job. 
OUTPUT 

1. The scheduler will read, process, and print (on the device 
Specified as SYSOUT by the operator) all job control statements. 

2. The compiler will read and list the source program on the device 
specified as SYSOUT by the operator. 

3. The compiler will prepare and list (on SYSOUT) the following: 

a. Message showing compiler options in effect 

b. Heading including date and level 

c. The source program 

d. Storage map including size of COMMON and size of program 

e. Message showing "END OF COMPILATION program- name" 

4. The linkage editor will prepare and list (on SYSOUT) a storage map 
including the relative address of each external reference. 

5. The FORTRAN load module will list (on SYSOUT) the results of 
execution. The results should correspond to the comments in the 
source program. 
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FORTRAN G AND H SAMPLE PROGRAM (lEYSP) 

The lEYSP card deck (punched from SYSI.SAMPLIB) consists of 

1. Job control language statements for a FORTRAN G or H compilation. 

2. FORTRAN sample program source statements. 

3. Job control language statements for a linkage edit and execution of 
the sample program. 

H. Data card for FORTRAN sample program execution. 

The sample program consists of one main program and one function 
subprogram, which together compute and print out binomial coefficients. 
The deck is composed of the following source statements: 





Main 


Program 


Subprogram 


Comments 




42 


19 


Specification 




1 


1 


Format 




5 




Read/Write 




5 




Control 




8 


13 


Arithmetic 




2 


13 




Total 


63 


46 



The program processes one data card as its input. The comments cards 
show a complete list of the expected output from the execution of the 
program and may be used for checking the output. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the lEYSP card deck in the card reader, ready reader, and 
press the End of File key. 

4. Ready the printer. 

5. Execute the job. 
OUTPUT 

1. The scheduler will read, process, and print (on the device 
specified as SYSOUT by the operator) all job control statements. 

2. The compiler will read and list the source program on the device 
specified as SYSOUT by the operator. 

3. The compiler will prepare and list (on SYSOUT) the following: 

a. Heading, including date and level 

b. The source program 

c. Storage map including size of COMMON and size of program 

d. The generated object code 

4. The linkage editor will prepare and list (on SYSOUT) a storage map 
including the relative address of each external reference. 

5. The FORTRAN load module will list (on SYSOUT) the results of 
execution. The results should correspond to the comments in the 
source program. 
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GRAPHICS SAMPLE PROGRAMS (SAMP2250 AND SAMP2260) 

The SAMP2250 card deck (sample program to exercise the 2250 Display 
Unit) and the SAMP2260 card deck (sample program to exercise the 2260 
Display Station, local) can be punched from SYSl .SAMPLIB. 

Each card deck consists of 

1. Appropriate job control language statements. Included is a cata- 
loged procedure (ASMFCLG) to assemble, linkage edit, and execute 
the compiled program. Before compiling either deck, the four 
over-ride cards below must be added to the end of the deck after 
the assembler language END card. 

/* 

//LKED.SYSLIB DO DSNAME=SYS1 .LINKLIB,DISP=OLD 

//GO. GRAPHIC DD UNIT =2250-1 

or //GO. GRAPHIC DD UNIT= (2260- 1 , 2) 

/* 

In the preceding statements, the underlined values must be replaced 
with the appropriate generic unit name of the 2250 or 2260 being 
tested. (See Appendix C.) Note that the GO. GRAPHIC DD statement 
for the 2260 specifies a collection of two devices. (For further 
information on collections of devices, see the publication IBM 
System/360 Operating System: Job Control Language .) 

2. Sample program input symbolic deck. 
OPERATING INSTRUCTIONS 

1. Insure that the graphic device is ON. 

2. Place the sample program deck in the card reader. 

3. Mount the operating system. 

4. Set the load address switches and press the Initial Program Load 
key to load the system. 

5. Perform assemble-link-edit-go. 

6. Follow instructions which appear on the display screen. 

OUTPUT 

The displays which appear on the 2250 Display Unit are shown in 
Figure 21. The displays which appear on the 2260 Display Station are 
shown in Figure 22. 



Testing the New System 131 



2250 SAMPLE PROGRAM - END ATTENTION TO BEGIN 



First Display 



JTHIS PROGRAM WILL PLOT A GRID WITH CORNERS AT 2400,2400-2400,4000- 
14000,4000-4000,2400. IT WILL PLOT 90 DEGREES OF ARC WHOSE RADIUS IS 
1 1200 RASTER UNITS. IT ILLUSTRATES THE USE OF ORDER MACROS TO CREATE 
I THIS DISPLAY AND PORS TO CREATE THE NEXT DISPLAY. 

I 

(DEPRESS KEY D AND THEN THE END KEY ON THE ALPHAMERIC KEYBOARD TO 

j INITIATE THE NEXT DISPLAY. 



b. Second Display 



THIS DISPLAY ILLUSTRATES THE OUTPUT OF THE GCGRID, GARC, 
AND GCPRNT PROBLEM ORIENTED ROUTINES. 

DEPRESS KEY E AND THEN THE END KEY ON THE ALPHAMERIC KEYBOARD TO 
TERMINATE THIS SAMPLE PROGRAM. 



c. Third Display 



Figure 21. 2250 Displays 
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a. First display 




PROCESSING COMPLETE - INSERT NEXT MI REQUEST 



b. Second display 




c. Third display 



Figure 22. 2260 Displays 
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GRAPHIC SUBROUTINE PACKAGE FOR FORTRAN IV SAMPLE PROGRAM (GSPSAMP) 
The GSPSAMP card deck (punched from SYSl.SAMPLIB) consists of: 

1. Appropriate job control language statements that will call a 
cataloged procedure (FORTxCLG) , where x=E, G, or H, to compile, 
linkage edit, and execute the program. The following cards are 
required after the FORTRAN Language END card: 

/* 

//LKED.SYSIN DD * 

INCLUDE SYSLIB(IHCGSP03) 
/* 

//GO. SYS ABEND DD SYSOUT=A 
//GO.FTOSFOOl DD UNIT=AFF=FT01F001 

//GO.FTIOFOOI DD UNIT=xxx (where xxx is the 2250 unit address) 
/* 

//SYS IN DD * 
(Data Cards) 
/* 

The //GO.FT05F001 DD statement must be omitted if FORTRAN G or H is 
used. 

2. Sample program input symbolic deck. 
OPERATING INSTRUCTIONS 

1. Insure that the graphic device is on. 

2. Place the sample program deck in the card reader. 

3. Mount the operating system. 

4. Set the load address switches and press the Initial Program Load 
key to load the system. 

5. Perform compile-link edit-go procedure. 

6. Follow instructions which appear with sample program in IBM 
Svstem/360 Operating System: Graphic Programming Services for 
FORTRAN IV , Form C27-6932. 

OUTPUT 

The displays which will appear on the 2250 Display Unit are shown in 
Figure 23. 
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C, Display Produced After Light Pen Attention on X Labeled 
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Figure 23. Display for GSP Sample Program 
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PL/I F SAMPLE PROGRAM (IEMSP2) 

The IEMSP2 card deck (punched from SYSl.SAMPLIB) consists of 

1. Job control language statements for a PL/I compilation, link edit, 
and execution of the compiled program. The cataloged procedure 
PLILFCLG is used. 

2. PL/I sample program source statements. 

3 . Input data . 

The purpose of the sample program is to illustrate the use of 
record-oriented input/output, initialization of STATIC arrays, and 
tabulation of data-directed output. Statements used include PROCEDURE, 
DECLARE, BEGIN, END, ON, GOTO, READ, WRITE, PUT EDIT, and PUT DATA. 

OPERATING PROCEDURES 

1. Mount the operating system. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the IEMSP2 card deck in the card reader, ready the reader, 
and press End of File. 

4. Ready printer. 

5. Execute the job. 
OUTPUT 

1. Job control language statements in the cataloged procedure. 

2. Normal compilation output: 

a. All source statements. 

b. An attribute and cross-reference listing. 

c. A list of errors found during the compilation, 

3. Normal link edit step output, 

4. The correct generated output is shown in Figure 24. 

r ' 1 

OUTPUT OF PL/1 SAMPLE PROGRAM 

THIS CARD IGNORED BECAUSE TYPE IS NOT NUMERIC :=& DELIBERATE DUD CARD 

TYPE{0)= 1 TYPE(1)= TYPE (2)= 4 TYPE (3)= TYPE (4)= 1 
TYPE(5)= TYPE(6)= 10 TYPE(7)= 1 TYPE(8)= 1 TYPE(9)= 0; 

END OF SAMPLE OUTPUT 

L J 

Figure 24. PL/I Generated Output 
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RPG SAMPLE PROGRAM (RPGSMPL) 

The RPGSMPL card deck (punched froir. SYSl.SAMPLIB) consists of 

1. Job control language statements to call a cataloged procedure for a 
compilation, linkage-edit, and execution of the sample program. 

2. Report Program Generator source statements; there are 45 of these. 

3. Data cards for the program to process; there are 13 of these, and 
no other input is necessary. 

The program processes the 13 data cards which contain details of 
customer transactions and prepares the report shown in Figure 12. A 
detailed description of the source program appears in IBM SysteKi/360 
Operating System: Report Program Generator Language , Form C2U-3337. 

OPERATING INSTRUCTIONS 



1. 
2. 



Mount the operating system and an initialized scratch pack. 

Set the load address switches and press the Initial Program Load 

key to load the operating system. 

Place the RPGSMPL card deck in the card reader, ready the reader, 

and press the End of File ke^'. 

Ready the printer. 

Execute the job. 



OUTPUT 



Program output will consist of a printed listing 
program and the printed report shown in Figure 25. 



of the source 



r— 


ACCOUNTS RE 


C E I V 


ABLE R 


E G I S T 


E R 






1 

1 
1 


1 CUSTOMER 




LOCATION 


INVOICE 


INVOICE 


DATE 






1 

INVOICE 1 


1 NUMBER 


CUSTOiVlE.R NAME 


STATE 


CITY 


NUMBER 


NO. 


DAY 




AMOUNT 1 
1 


1 10712 


AMALGAMATED CORP 


33 


61 


11603 


11 


10 


$ 




389.25 1 
389.25* 1 


1 11315 


BROWN WHOLESALE 


30 


231 


12324 


12 


28 


$ 




802.08 1 


i 11315 


BROWN WHOLESALE 


30 


231 


99588 


12 


14 


$ 
$ 


1 


261.17 1 
,063.25+ 1 


1 11897 


FARM IMPLEMENTS 


47 


77 


10901 


10 


18 


$ 




27.63 1 
27.63* 1 


1 18530 


BLACK OIL 


16 


67 


11509 


11 


8 


$ 




592.95 1 


1 18530 


BLACK OIL 


16 


67 


12292 


12 


23 


$ 
$ 


1 


950.97 1 
,543.92* 1 


1 20716 


LEATHER BELT CO 


36 


471 


11511 


11 


8 


$ 




335.63 1 


1 20716 


LEATHER BELT CO 


36 


471 


12263 


12 


17 


$ 
$ 




121.75 1 
457.38* 1 


1 29017 


GENERAL MFG CO 


6 


63 


11615 


11 


14 


$ 




440.12 1 


1 29017 


GENERAL MFG CO 


6 


63 


11676 


11 


23 


$ 


1 


722.22 1 
,162.34* 1 


1 29054 


A-B-C DIST CO 


25 


39 


9689 


9 


11 


$ 




645.40 1 


1 29054 


A-B-C DIST CO 


25 


39 


11605 


11 


11 


$ 




271.69 1 


1 29054 


A-B-C DIST CO 


25 


39 


12234 


12 


14 


$ 
$ 
$ 


1 
6 


559.33 1 
,476.42* 1 
,120.19**1 


i_ 



















J 



Figure 25. RPG Sample Program Printed Report 
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SORT/MERGE SAMPLE PROGRAM (lERSP) 

The lERSP card deck (punched from SYSl.SAMPLIB) consists of: 

1. Job control language statements for TAPESORT. 

2. Job control language statements for DISKSORT. 

3. Data to be sorted. 

The data to be sorted consists of 500 80-character records, each 
containing a 6-digit sequence number and a 10-character control field. 
As provided, the data deck is in the 6-digit sequence number order. The 
SORT control card specifies that the data is to be sorted on the 
10-character control field. The output of either a TAPESORT or a 
DISKSORT will be in 10-character control field sequence. 

The TAPESORT job control language statements provided in lERSP call 
for four tape units (three for scratch and one for SORTOUT) . To use 
more than three work tapes, additional cards may be added behind the 
SORTWK03 DD card. They should be identical to other SORTWK DD cards 
except for DD name which must be consecutive, i.e., SORTWK04, 
SORTWK 05 , , SORTWK 3 2 . 

The DISKSORT job control language statements provided in lERSP call 
for six work areas of 30 contiguous tracks each on a 2311. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. For a TAPESORT, the data deck should be placed on tape as one 
unblocked sequential data set. An operator message (during step #7 
below) will give mounting instructions. 

For a DISKSORT, the data deck should be placed on the scratch pack 
(mounted in step #1 above) as one unblocked sequential data set and 
cataloged under the name TEST. 

4. For a TAPESORT, place the TAPESORT job control language statements 
in the card reader. 

For a DISKSORT, place the DISKSORT job control language statements 
in the card reader. 

5. Ready the reader and press the End of File key. 

6. Ready the printer. 

7. Execute the job. 

OUTPUT 

A message to the operator will indicate the unit assigned to SORTOUT 
(unit containing output) . This output can be printed and reviewed. The 
records will be in 10-character control field sequence. 

Output of TAPESORT will be on tape. 

Output of DISKSORT will be on disk. 
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UPDATE ANALYSIS PROGRAM SAMPLE PROGRAM (IHGSAMP) 

The IHGSAMP card deck (punched from SYSl.SAMPLIB) consists of 

1. Job control language statements and data to accomplish Stage 1, 
steps 1, lA, 2, 3, 4, 5, 6, and 7 described in "Output" below. 

2. Job control language statements to accomplish Stage 2, steps 3, U, 
5, and 6. 

This sample problem is a two-stage operation requiring two input card 
decks. The Stage 1 input deck is complete. However, the output created 
by Stage 1 must be placed in front of the Stage 2 input deck before 
Stage 2 can be executed (The output of Stage 1 is the job control 
language statements to accomplish Stage 2, steps 1 and 2.) 

In order to demonstrate the functions of Update Analysis, it is 
necessary to create some data sets on a disk pack of the operating 
system. However, the sample problem has been constructed so that at its 
completion all data sets created by it are deleted. Therefore, the 
program can be run without leaving residue from its operations on the 
system disk packs. The printer output acts as a graphic demonstration 
of the changing programs. 

Stage 1 builds two sample symbolic libraries and one sample change 
library. It then executes the Update Analysis Program which creates the 
job stream required to update the sample libraries. Stage 2 utilizes 
the output of the Update Analysis to update the two sample libraries, 
then proceeds to eliminate the data sets from the system. This is 
described in the section "Output." 

OPERATING INSTRUCTIONS 

1. Mount the operating system and initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place Stage 1 card deck in reader and ready the reader, printer, 
and punch. 

U. Execute the Stage 1 job stream. 

5. At the end of the job, take the output of Stage 1 from the punch 
stacker and place in front of Stage 2 deck. 

6. Place Stage 2 deck in reader and ready reader. 

7. Issue commands: 
START RDR, OOC 
START 

to execute the Stage 2 job stream. 

OUTPUT 

Stage 1 

Step 1 EXEC lEBUPDAT 

This step creates a temporary data set that contains the SYS IN 
control cards for step lA. 

Step lA EXEC lEBGENER 

This step creates the PDS SAMPLCHG which is the change PDS 
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containing three change members to be applied to the two 
sample libraries. 

Step 2 EXEC lEBUPDAT 

This step creates the PDS SAMPLIBl which is a sample system 
library containing two members: lyiEMBERl and MEiyiBER2. 

Step 3 EXEC lEBUPDAT 

This step creates the PDS SAMPLIB2 which is a sample system 
library containing one member: MEMBERS. 

Step 4 EXEC lEHLIST 

This step lists the directories of the two sample libraries. 
The list will show the SSI bytes of the members prior to 
updating. 

Step 5 EXEC IHGUAP 

This step causes the SAMPLCHG PDS to be analyzed and creates 
the job stream which will update the sample system libraries. 
For the purpose of the sample problem, this output is 
temporarily stored on disk to be available for steps 6 and 7. 

Step 6 EXEC lEBPTPCH 

This will print the output of step 5. 

Step 7 EXEC lEBPTPCH 

This will punch the output of step 5. 

Stage 2 

Steps 1 (tJsing punched output from step 7 
and 2 of Stage 1) 

EXEC lEBUPDAT Update SAMPLIBl 

EXEC lEBUPDAT Update SAMPLIB2 

Step 3 EXEC IEHLIST 

This step lists the directories of the two sample libraries. 
The list will show the SSI bytes of the members after they 
have been updated. 

Step U EXEC lEBUPDAT 

This reproduces SAMPLIBl in its updated form. This operation 
creates a printed list which shows the effect of the change. 

Step 5 EXEC lEBUPDAT 

This reproduces SAMPLIB2 in its updated form. It creates a 
printed list which shows the effect of the change. 

Step 6 EXEC lEHPROGM 

This causes the deletion of data sets SAMPLCHG, SAMPLIBl, and 
SAMPLIB2. 
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EXAMPLES 



This section contains two examples of system generation. Example 1 
shows a complete system generation, a Processor/Libraries generation, 
and a Nucleus generation. Example 2 shows a complete generation using 
the Starter Operating System. 

The machine configurations and operating systems shown in these 
examples are not meant to represent the needs of an average installa- 
tion, but were chosen because of their value as examples. 

EXAMPLE 1 

This example consists of: 

• Diagram of a machine configuration 

• Diagram of the volumes that contain generating and new system data 
sets 

• Deck for initializing new system data sets 

• Deck for system generation 

• Creating back up of new system 

• Scratching utility data sets 

• Using the generating system to add a new compiler and library to the 
new system 

• Cataloging the generating SYSl.GENLIB and SYSl.MODLIB in the new 
system 

• Using the new system to add a second nucleus to itself 
Machine Configuration 

Figure 26 shows the machine configuration used in this example. 
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IBM SYSTEM/360 MODEL G40 



CHANNEL 



CHANNEL 1 



CHANNEL 2 



1052-7 
PRINTER- 
KEYBOARD 



010 



2540-1 
READER 
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00B 



2841 
STORAGE CONTROL 



2821-5 
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PRINTER 
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2311 DISK 

STORAGE 

DRIVE 
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2311 DISK 

STORAGE 

DRIVE 
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2841 
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2311 DISK 
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STORAGE 

DRIVE 



252 



1403-3 
PRINTER 



00D 



Figure 26. Example 1: Machine Configuration 



144 



Volumes Used for System Generation 

Figure 27 shows the volumes that contain the generating and new 
system data sets. The serial number of the generating system residence 
volume is 111111. Volumes 222222 and 333333 contain the remaining 
generating system data sets. The serial number of the new system 
residence volume is SYSTEM. Volume LINVOL contains the remaining new 
system data sets. The four utility data sets used during system 
generation are named SYSl.MOD, SYSl.ONE, SYSl.TWO, and SYSl. THREE. The 
SYSl.USER data sets contain user-written routines for the new system. 




SYSl SYSJOSQg, 



•JY S1. SVCUg , 
jV Sl. LIN KLig, 
.SYSCTL6____ 
-JY gl. PROCLi g, 
JY Si. SORTU g. 
jV gl COBLIg ^ 
•jj gj. FORTLi g, 
4Y S1. PLILiB ^ 
^JYSl. NUCLEUS 
.§YS1_L0GR|C_ 
^S1. THRee. 




222222 

S YSl. MACU g. 
S YSl. TWO_ ^ 
SYS1. USEK. 



333333 
SYSl. ONE 




jY SCTLG 
jY Sl. SVCLIg ^ 
JV S1. MACU g^ 
jY Sl HUClB QS 

JVS l. LOGRg S 
^SYSlMOD 



JY Si. SORTU g, 
^1. FORTU0 



Figure 27- Example 1: Generating and New System Volumes 
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Deck for Initializing New System Data Sets 

Figure 28 shows the input deck for initializing the new system data 
sets. During this initialization, volumes 111111, SYSTEM, and LINVOL 
must be mounted. The configuration used in this example (Figure 26) 
allows the simultaneous mounting of all five volumes (Figure 27) 
involved in this generation. Therefore, to simplify operating proce- 
dures, all five volumes should be mounted at this point. It is assumed 
that there is no dependency on device addresses, and that the volumes 
can be mounted on any 2311 drive. For illustrative purposes, assume 
that volumes 111111, 222222, 333333, SYSTEM, and LINVOL are mounted on 
drives 161, 162, 163, 251, and 252, respectively. 



//SYSGEN JOB MSGLeVtL=l -EXAMPLE 1- 

//STEPO EXfcC PGH=I£HPROGM -ALLOCATE ON 2311- 

//SYSPRINT DD SYSOUT=A 

//CATALOG DD OSNAMe= SY SCTLG, VOLUME= { ,RETAI N, SER=SYSTEN) , X 

// UNIT=23U,0ISP={,KEEP),SPAC£ = (TRK,(l0,in » X 

// LABEL=EXPDT=99350 

//SVCLIB 00 DSNAMe=SYSl.SVCLI 8, VOLUMF=( , RETAIN, SER=SYSTEM) , X 

// UNI T= 2311 ,DISP=( ,KEEPJ,SPACE=(TRK,(150 ,,75) ,,CONTIG), X 

// LABEL=EXPDT=993 50,OCB=COSORG=POU,RECFM=U,8LKSIZE=1024) 

//HACLIB DU DSNAME=SYS1.MACLIB,V0LUME=( , RETAIN, SER=SYSTEM) , X 

// UNIT=2311,LISP=i,KEEP),SPACE = (TRK,(440,50,2e>) ) , X 

// LAB£L=EXPDT=99350 ,DCB=(RECFM=FB,BLKSI ZE=3360,LRECL=80) 

//NUCLEUS DD DSNAME= SYS 1 .NUCLEUS , VOLUME= { ,RETA I N , SER=SYSTEM ) , X 

// UNIT=231l,UISP=(,Kfc£P) ,SPACE=(TRK,(60, ,2) ,,CONTIG) , X 

// LABtL=EXP0r=99350 

//JOBQE DD DSNAME=SySl.SYSJaBQE,VOLUME={ , RETAIN, SER=LINVOL) , X 

// UNIT=2311,LISP=( ,KEEP) ,SPACE=(TRK,U20) ,,CONTIG) 

//LINKLIB DO DSNAHE=SYS1.L INKLIB,VOLUME=(, RETAIN, SER=LINVOL), X 

// U(S1IT=2311,DISP = (, KEEP), SPACE = (TRK, (1100,, 100) , ,CONTIG) , X 

// LABEL=EXP0T=99350,DCB=(RECFM=U,BLKSIZE=3 62 5) 

//PROCLIB DO 0SNAME=SYS1.PR0CLIB,V0LUME=( , RETAIN, SER=LINVOL), X 

// UNIT=2311 ,OISP=(, KEEP), SPACE = (TRK, (30, 10,9) ) , X 

// LABEL=EXPDT=99350,OCB=(RECFM=F,8LKSIZE=80) 

//SORTLIB DD DSNAME=SYS l.SORTL IB , VOLUME= ( ,RE TA I N, SER=L I NVOL ) , X 

// UNIT=231l,DISP=(, KEEP), SPACE=(TRK, (60, 2,40) ) , X 

// LABEL = EXPO 1 = 99350, DCB = (RECFM = U,BLKS I ZE = 362 5) 

//COBLIB DO DSNAME=SYS1.C0BLIB,V0LUME=( , RETAIN, SER=LINVOL) , X 

// UNIT=2311,D1SP=(,KEEP),SPACE = (TRK,(35,2,30) ) , X 

// LABEL=EXPD1=99 350,0CB=(RECFM=U,8LKSIZE=3 625) 

//FORTLIB DO DSNAME= SYS 1 .FORTL IB, VOLUME = ( ,RE TA IN, SER=LI NVOL ) , X 

// UNIT=2311 ,CISP=(, KEEP), SPACE=(TRK, (50, 2,40) ) , X 

// L ABEL= EXP DT=99350, 0CB=(R EC FM=U,BLKS I ZE= 362 5) 

//SYSIN DD * -INPUT FOR CATALOGING SYSTEM DATA SETS- 

CATLG CVOL=2311=SYSTEH,VOL=2311=LINVOL,DSNAME=SYSl.LINKLIB 

CATLG C VOL = 23 1 1= S Y STEM, VO L=23 1 l=LIN VOL, DSNAME=SY SI, PROCLIB 

CATLG CVOL=2311=SYSTEH,V0L=2 311=SYSTEH,0SNAME=SYSl.MACLIB 

CATLG C VOL = 23 1 1 = S YSTEiM, VUL=2311 = L IN VOL, DSNAME = SYS1. SORTLIB 

CATLG CVOL=23ll=SYSTEM,VOL=2 311=LINVOL,DSNAME=SYSl.COBLIB 

CATLG CVOL=2311=SYSTEM,V0L=231l=LINVOL,0SNAME=SYSl. FORTLIB 

CATLG C VOL= 23 11=SYSTEM,V0L=2311=SYSTEM,0SNAME=SYS1. SVCLIB 



Figure 28. Example 1: Initializing New System Data sets 
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Input Deck for Stage I 

Figure 29 shows the input deck for system generation. The utility 
data sets are allocated space on the volumes indicated in Figure 27. 
The job stream will be written on an unlabeled magnetic tape that 
resides on drive 190 (see Figure 26) . Stage II will be started 
automatically after Stage I is completed. Generic unit names are used. 
This input deck is the second step of the job defined in Figure 28. 



The new system supports all devices in Figure 26. The primary 
control program (PCP) is used. BDAM, BISAM, QISAM, Assembler E, COBOL 
E, FORTRAN E, sort/merge, and RPG are included in the new system. The 
compilers have all standard default options for compilation time. The 
procedure library and the unit names it requires are also included. An 



user-written routine named NUCID is included in the nucleus, 
member of the SYSl.USER data set. 



NUCID is a 



-STAGE I INPUT- 



//STEPl EXEC PGM=ASM8LR 

//SYSLIB DO DSNAME=SySl,GENLIB,DISP=QLO 

//OBJPOS DO OSNAME=SYS 1, MOD, VOLUHe = (, RETAIN, SER = SYSTEM) , 

// DISP={ ,CATLG),UNIT=231l,SPACE=(TRK,C40,20,8) ) 

//SYSUTl DD DSNAM£=SYS1. ONE, VOLUME={, RETAIN, SER=333333), 

// OISP=C,CATLGI,UNIT=23ll,SPACE=(TRK,(240,20)) 

//SYSUT2 DD 0SNAHE=SYS1. TWO, VOLUME=(, RETAIN, SER=222222), 

// OISP=i ,CATLG},UNIT=23ll,SPACE=( TRK, (240,20 ) ) 

//SYSUT3 00 OSNAME=SYS 1. THREE ,VOLUME=( , RETAIN, SER=lllllI J , 

// OISP=(,CATLG),UNI T=231I , SPACE=( TRK, (300, 20 ) ) 

//DUMMY DO VOLUME=(, RETAIN, R£F=*.SYSUT3),SPACE=(TRK, (80)) 

//SYSPUNCH DO UNIT=190,LA8EL=(,NL) 

//SYSPRINT DO SYSOUT=A 

//SYSIN on * 



CHANO 

CONSOLE 

CONTOO 

READOOA 

PUNCHOOB 

PRINTOOC 

PRINTOOD 

CHANl 

CaNTI6 

0ISK161 

0ISK162 

DISKI63 

C0NT19 

TAPEI90 

TAPE191 

TAPE192 

TAP El 93 

CHAN2 

C0NT25 

DISK25I 

0ISK252 

0ISK253 



DO 

DO 

DO 

DO 

CENPROCS 
CHANNEL 
lODEVICE 
lOCONTKL 
lOOEVICE 
lODEVICE 
lODEVICE 
lOOEVICE 
CHANNEL 
lOCONTRL 
lODEVICE 
lOOEVICE 
lOOEVICE 
lOCONTRL 
lOOEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
CHANNEL 
lOCONTRL 
lODEVICE 
lODEVICE 
lODEVICE 



MODEL =40, STORAGE =G, I NSTSET=UNIV, FEATURE =PROTECT 

ADORESS=0,TYPE=MULTI PLEXOR 

UNIT= 1052,M00EL=7,AD0RESS=010 

UNIT=282l,MODEL=5,ADORESS=00,TRNMODE=8URST 

UNIT=2 54OR,MO0EL=l,AODRESS=00A 

UNIT=2540P,MaOEL=l,A0DRESS=008 

UNir= 140 3, M00EL=3, ADORE SS=OOC,FEATURE=UNVCHSET 

UNIT=140 3,M0 0EL=3,ADDRESS=000,FEATURE=UNVCHSET 

ADORE SS=1,TYPE=SELEC TOR 

UNIT=2841,A0 0RESS=I6 

UN IT = 2311, AD OR ESS= 161 

UN I I =231 l,AD0RESS=162 

UNIT^2311,A0DRESS=163 

UNIT=2403,M0DEL=3,A0DRESS=19 

UNI T= 2403, M0DEL=3,A0DHESS= 190, FEATURE=9-TRACK 

0NIT=240l,MaOEL=3,ADDRESS=191,FEATURE=9-TRACK 

UNIT=2401,«UDEL=3,A00RESS=192,FEATURE=9-TRACK 

UNIT=2401,M0DEL=3,ADDRESS=193,FEATURE=9-TRACK 

ADORE SS=2,TYPE=SELEC TOR 

UNIT=2841,A0l3RESS=25 

UN I T= 231 1 , AOOR ES S=25 1 

UN IT = 2311, ADORES S = 252 

UNIT=23ll,A0DRESS=253 



Figure 29. Example Ir Stage I Input Deck (Part 1 of 2) 
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UNITNAME NAME=SYSSQ,UNIT={ 161,162,163,190,191,192,193,253) 
UNITNAME NAME=SYS0A,UjMIT=(161, 16 2,163,2 53) 

UNITNAME NAME=SYSCP,UNIT=OOB 

UNITNAME NAME = 7APE,UNIT = ( 190, 191,192,193) 

CTRLPROG TYPE=PCP,MAX 10 = 15, OVERLAY=AOVANCED 

SCHEUULR C0NS0LE=010, ACCTRTN=SUPPLieO, X 

VLMOUNT=AVR,CANCEL=(NONAME,N0ACCNUM) 
SUPRVSUR RESIONT={ATrACH, EXTRACT, IDENTIFY) , WAIT= MULT I PLE , X 

OPTIDNS=( rRSVCTbL,PR0TECT),TRACE=100,SER=SERl 
PROCLia UNCT=2311,V0LN0=LINV0L 

PDS=SYSi.US£R,HEH8ERS=NUCI0 

ACSHETH=CBOAH, ISAM) 

DESIGNEE 18 

0ESIGN=E44 

DtSIGN=E 

PHASES=C INTER, EDITOR ) , P AGES=50, EXEC = 200 , iMOOE = TR ACE 



RESMOOS 
DATAMGT 
EDITOR 

EDITOR 

ASSEMBLR 

FESTHAN 

MACLI8 

CHKPOINT 

SURTMERG 

SORTLIB 

COBOL 

C0BLI8 

FORTRAN 

FORTLIB 

RPG 

GENERATE 



SORTOPT=FULL IB , S I ZE=51 200 

UNIT=2311,VULNG=LINVOL 

DESIGNEE 

OESIGN=E,UNIT=2311,VULNO=LINVOL 

OESIGN=E 

DESIGNEE, UNI T=231l , VOLNG=LINVOL ,0B JERR=03 



UTiSnS=SYSl.UNE,UT2S0S=SySl.TW0,UT3SDS=SYSl.THRE£, X 
OBJPl)S = SYSl.MOO,RESNAME=2 3ll,RESVOL = SYSTEM,RESTYPE = 2 3ll,X 
LNKNAHE = 2 3 11, LNKV OL =L I N VOL , L HMA I NT = £ , A SMPR T= ON , X 

LEPRT = (LIST,XREF) ,DIRUATA = P9S 



END 






STAR! 



ROR, 190 



Figure 29. Stage I Input Deck (Part 2 of 2) 



Backup of New System 

Figure 30 shows the input decks for the IBCDMPRS independent utility 
program for creating the backup of the new system. The backup copy is 
on magnetic tape. magnetic tape. It is assumed that SYSTEM is mounted 
on drive 251, and LINVOL on drive 252. After the two backup copies have 
been made, the two magnetic tapes on 191 and 192 should be removed and 
stored in the tape library. 



DUMPl JOB 

MSG TODEV=1U03,TOADDR=OOC 

DUMP FROMDEV=2311,FROMADDR=251, TODEV=2400 ,T0ADDR=191 

END 

DUMP 2 JOB 

MSG TODEV=1403,TOADDR=00C 

DUMP FROMDEV=2311 , FROMADDR=252 , TODEV=2400, TOADDR=192 

END 

L '. J 

Figure 30. Example 1: Creating Backup of SYSTEM and LINVOL 
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Scratching Utility Data Sets 

After the new operating system is generated, SYSl.ONE, SYSl.TWO, and 
SYSl. THREE' should be scratched and uncataloged. The job stream and 
SYSl.MOD should be saved. Figure 31 shows the input deck for scratching 
and uncataloging the three sequential data sets. The magnetic Cape that 
contains the job stream can be removed from unit 190 and stored in the 
tape library. SYSl.MOD remains in the new system residence volume 
(SYSTEM) to be used later on in this example. The lEHPROGM utility 
program is executed under control of the generating system. 



r ■ 

I //SCRATCH JOB MSGLEVEL=1 -SCRATCH DECK- 

I//STEPO EXEC PGM=IEHPROGM 

|//SYSPRINT DD SYSOUT=A 

I//SYSUT1 DD DSNAME=SYSl. ONE, DISP=( OLD, DELETE) 

I//SYSUT2 DD DSNAME=SYS1. TWO, DISP=(OLD, DELETE) 

I//SYSUT3 DD DSNAME=SYS1. THREE, DISP=( OLD, DELETE) 

I //SYS IN DD DUMMY 

L 

Figure 31. Example 1: Scratching Utility Data Sets 



Processor/Library Generation 

After the new operating system has been generated, the PL/I compiler 
and SYSl.PLlLIB are to be added to it. This system generation will be 
performed under control of the generating system (volumes 111111, 
222222, and 333333) . 

Figure 32 shows the input deck for this generation. STEPl allocates 
space (on LINVOL) and catalogs the new SYSl.PLlLIB. STEP2 is the input 
deck for Stage I. Three sequential utility data sets are defined. 
Their names are SYSl.UTl, SYS1.UT2, and SYS1.UT3 and they reside on 
volumes 333333, 222222, and 111111, respectively. The SYSl.MOD parti- 
tioned data set used in the previous generation is used again. This can 
be done because only new components are added to the new system during 
this Processor/Library generation. The job stream will be written on an 
unlabeled magnetic tape that resides on drive 191. 

After Stage II has terminated, SYSl.UTl, SYS1.UT2, and SYS1.UT3 can 
De scratched and uncataloged. The job stream tape should be saved. 
SYSl.MOD can be copied onto some removable volume and saved. The 
generating system can be removed. The new system is ready to operate 
after initial program load (IPL) . 
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//SYSGEN 

//STEPl 

//SYSPRINF 

//PLILIB 

/ / 

t / 

//SYSIH 

CATLG 

//STEP2 
//SYSLII 

//UBJPOS 

//SYSUTl 

f f 

//SYSUT2 

If 

//SYSUT3 

f f 

//DUMMY 

//SYSPUNCH 

//SYSPRINT 

//SYSIN 



JOB MSGLEVEL=l 
EXEC PGM=IEHPROGM 



■PROCESSOR/LIBRARY GENERATION- 
-ALLOCATE SYSI.PLILIB- 



DD SYSOUT=A 

OD OSNAMfc=SYS 1 .PL ILC 8, VOLUME = ( ,RETAI N, SER=L I NVOL ) , 
UNI T= 2311 ,DISP=(,KEEP),SPACE = CTRK,(80,10,65) ) , 
LABEL=EXP0T=99 350,0CB={RECFH=U,BLKSIZE=3 62 5) 

00 * 

CVOL=2311=SYSTEH,VOL=23ll=LINVOL,USNAME=SYSl.PLlLIi 



EXEC PGM=AS 

00 DSNAHE= 

DO OSNAME= 

DO DSNAHe= 

DISP=C , 

DO DSNAME= 

DISP={ , 

DO DSNAf1fc= 

OISP=( , 

DO VOLUME= 

DO UNIT=19 

DO SYSOUT= 

00 * 

CENPROCS iMO 

SUPRVSOR 9.^. 

OPTIONS 

PLl DESIGN= 

PLILIB UN 

GENERATE GE 

UT3SDS= 

RESVOL= 

LBMAINT 

END 



M3LR 

SYS l.GENLI 

SYS1.MU0,D 

SYS l.UT.ltV 

CAT'LG) ,UNI 

SYS1.UT2,V 

CATLG),UNI 

SYS1.UT3,V 

CArLG),UNI 

{ , RETAIN, R 

l,LABEL=C, 

A 

DEL=40,STO 

SIONT=(ATT 

= J TRSVCTBL 

F 

IT=2311,VO 

NTYPE=PROC 

SYSi.UT3,0 

SYSTEM, RES 

=E,ASMPRT= 



-STAGE I INPUT- 
B,DISP=OLO 
ISP=OLO 

OLUHe=I, RETAIN, SER=333333) , 
T=231l,SPACE=(TRK,(240,20) ) 
ULUM£=(, RETAIN, S€R=222222) , 
T=2311,SPACE=l TRK,(240,20) ) 
OLUME={, RETAIN, SER=llllll) , 
T=2311,SPACE=l TRK, (300,20)) 
EF=*..SYSUT3),SPACE=(TRK, (80)) 
NL) 



RAGE=Gf I NSTSET=UN IV, FEATURE = PROTECT 
ACH,EXTRACT,IDENTIFY),«AIT=MULTIPLE, 
, PROTECT ),TRAC£ = 100,SER = SER1 

LNO=LINVOL,LIBFCNS=COMPL£X 

£SS0R,UT1SDS=SYSI.UTI,UT2S0S=SYS1.UT2, 

6JP0S=SYS1 .MOD,RESNAM£=23ll , 

TYPE=2 311,LNKNAME=2311,LNKVOL=LINVOL, 

ON,LEPRT={LIST,XReF),DlRDATA=POS 



/* 
// 



START 



RDR, 191 



Figure 32. Example 1: Processor/Library Generation 



Obtaining SYSl.GENLIB and SYSl.MODLIB 

After the new operating system has been generated and PL/I has been 
included, a second nucleus is to be added to SYSl . NUCLEUS . This nucleus 
generation can be performed under control of the generating system 
(volumes 111111, 222222, and 333333). However, this example shows how 
the new system can be converted into a generating system, and how it can 
add a new nucleus to itself. 

The new system (volumes SYSTEM and LINVOL) meets all the requirements 
for a generating system except that it does not have SYSl.GENLIB and 
SYSl.MODLIB. These two libraries can be copied from the generating 
system to the new system, and then cataloged. However, because there 
are enough drives to mount volumes SYSTEM, LINVOL, 222222, and 333333 
simultaneously, SYSl.GENLIB and SYSl.MODLIB need only be cataloged in 
the new system. Figure 33 shows the input decJc for cataloging 
SYSl.GENLIB and SYSl.MODLIB in the new system. The SYSl. USER data set 
that resides on volume 222222 is also cataloged in the new system. This 
cataloging is performed under control of the new system. 
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r 

j/ZGENMOD JOB MSGLEVEL=1 -GENLIB&MODLIB- 

j/ZCATLG EXEC PGM=IEHPROGM 

|//NEWRES DD aNIT=2311,VOLUME=SER=SYSTEM,DISP=OLD 

J/ZSYSPRINT DD SYSOUT=A 

I //SYSIN DD * 

I CATLG DSNAME=SYSl.GENLIB,VOL=2311=222222 

I CATLG DSNAME=SYSl.MODLIB,VOL=2311=333333 

I CATLG DSNAME=SYSl.USER,VOL=2311=222222 

[/* 

L J 

Figure 33. Example 1: Cataloging SYSl.GENLIB and SYSl.MODLIB 

Nucleus Generation 

A second nucleus (02) is added to the new system during this 
generation. The same CENPROCS, CHANNEL, lOCONTRL, and lODEVICE macro- 
instructions included in the generation of the new system (see Figure 
29) must be included in this generation. The new nucleus will support 
the same access methods (BDAM, BISAM, and QISAM) TESTRAN options, and 
checkpoint/restart facility as the first nucleus. Each nucleus must 
support the same control progratm (PCP) , because the resident portion of 
the control program (nucleus) must be compatible with the nonresident 
portion. 

Figure 34 shows the volumes involved in this generation. The four 
system generation utility data sets are named SYSl. OBJECT, SYSl.UTILl, 
SYS1.UTIL2, SYS1.UTIL3. 

Figure 35 shows the input deck to system generation. There is no 
allocation step before Stage I because the only library affected by a 
Nucleus generation is SYSl . NUCLEUS . The job stream will be written on 
an unlabeled magnetic tape that resides on drive 190. A user-written 
routine named NUCID2 is included in the nucleus. NUCID2 is a member of 
the SYSl. USER data set. 
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SYSTEM 

JV SCTL6 _ ^ 
-§V S1.SVCLI6 .,^ 
jY Sl.MACU g^ 
JY S1. NUCLe jj§> 
^S1. LOGRgC-- 



LINVOL 

j ^1. SYSJOg gi^ 
JV S1. LiNKLl B^ 
jV gl, PROCiJ B, 

jV g1. SORTL lg^ 
jV SlCOBLi g^ 
JY SI. FORTU g. 
■J YSI. PUU3 ^ 
^1. UTIL3^ 



ZZZZZ2 

S^lGENLlg 

SYSl USER 





SYS1. oBJacT 



Figure 34. Example 1: volumes for Nucleus Generation 
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//SYSGEN 

//STEP 

//SYSLIB 

//OBJPDS 

ft 

//SYSUTi 

// 

//STSUT2 

// 

//SYSUT3 

f f 

//DUMMY 

//SYSPUNC 

//SYSPRIN 

//SYSIN 

CHANO 

CONSOLE 

CUNFOO 

KEADOOA 

PUNCHOOa 

PRINTOOC 

PRIiMTOOD 

CHANl 

CnNT16 

DISK161 

0ISK162 

0ISK163 

C0NT19 

TAPE190 

rApei9i 

rAPE192 
TAPE193 

CHAN2 

CONT25 

DiSK2t>l 

DISK252 

OiSK253 



JOB MCR,67,MSGLEVEL= 
EXEC PGM=ASMaLR 
DO DSNAME=SYS l.GENLI 
DO DSNAHE=SyS1.0BJEC 

DISP={ ,CATLG),UNI 
DO DSNAHE=SYS1.UTILI 

DISP=(fCArLG) ,UNI 
Q\:i DSNAME=SYS 1.UTIL2 

OISP=( ,CATLG),UNI 
DO 0SNAME=SYSl.UriL3 

OISP=( tCAFLG) ,UNi 

VULUHt=( , RETAIN, R 

UNIT=190,LABEL=(, 

SYSOUT=A 



/* 

// 



DO 

DO 

DO 

DO * 
CENPROCS 
CHANNEL 
inOEVICE 
lOCONTRL 
lOUEVICE 
lOOEVICE 
lODEVICE 
lOUEVICE 
CHANNEL 
lOCONTKL 
lOUEVICE 
lOUEVICE 
lODEVICE 
lOCONTHL 
I DOE VICE 
lOOEVICE 
lOOEVICE 
lOOEVICE 
CHANNEL 
lOCUNTRL 
lODEVICE 
lOOEVICE 
lODEVICE 
CTRLPROG 
SCHEUULR 



1 -NUCLEUS 

-STAGE I 
8,DISP=0LD 
T,VOLUME=(, RETAIN 
T=23UfSPACE = < TRK 
,VOLUME=(, RETAIN, 
T=231I,SPACE={ TRK 
tVOLUME=i, RETAIN, 
T=23I1,SPACE=(TRK 
,VOLU.ME=( , RETAIN, 
T=231I,SPACE={TRK 
EF=*.SYSUT3),SPAC 
NLI 



GENERATION- 
INPUT- 

,SER=999999) 
,(40,20,8) ) 
S£R= 333333) , 
,(240,20)) 
SER=222222) , 
,(240,20)) 
SER=LINVOL) , 
,(300,20)) 
E=(TRK,(80) ) 



MODEL =40, STO 
ADORE SS=0,TY 
UNIT=1052,M0 
UNIT=2821,M0 
UNIT=2540R,M 
UNIT=2540P,M 
UNIT=I403,M0 
UN I T= 140 3, MO 
ADOR£SS=lf TY 
UNIT=2841,AD 
UNIT=2311,AO 
UNir=23Il,A0 
UNir=2311,AD 
UNIT=2403,MO 
UN IT = 2403, MO 
UN I T= 2401, MO 
UN I T= 2401, HO 
UNI T= 240 I, MO 
ADDRESS=2,TY 
UN I T= 2841, AD 
UNIT=2311,AU 
UNIT=2311,AD 
UN I T = 2311, AD 
TYPb=PCP,MAX 
CONSULE=010, 

0ESIGN=44K, CANCEL 
SUPRVSOR R£SIONT=(ATT 

UPTIDNS=( TRSVCTBL 

SER=SER1 



RAGE=G,INSTSET=UNIV, 

PE=MULTIPLEXOR 

0EL=7,ADORESS=0I0 

0EL = 5 , ADORE SS=00 , TRN 

00EL=1,ADDRESS=00A 

O0EL=l,AOORESS=008 

0EL=3,ADDRESS=00C,FE 

DEL=3,A0DRESS=00O,FE 

PE=SELECTOR 

0RESS=16 

DRESS=161 

ORES S= 162 

ORES S= 163 

0EL=3,ADnRESS=19 

DEL=3, ADDRESS=190,FE 

0EL=3,ADDRESS=191,FE 

0EL=3, ADORE SS=1 92, FE 

DEL=3,AD0RESS=193,FE 

PE=SELECTOR 

URESS=25 

DRESS=251 

0RESS=2 52 

URESS=253 

I0=15,FETCH=PCI 

ALTCONS=( I-OOA,0-OOC 

=(NONAME,NOACCNUM) 

ACH, EXTRACT, IDENTIFY 

,PROTECT,COHM),WAIT= 



FeArURE=PROTECT 



MODE=BURST 



ATURE=UNVCHSET 
ATURE=UNVCHS£T 



ATURE=9-TRACK 
ATURE=9-TRACK 
ATURE=9-TRACK 
ATUR€=9~TRACK 



) ,ACCTRTN=SUPPLIEO,X 

,BL0LTA8,ACSMETH) , X 
MULTIPLE, TRACE=100, X 



RESMODS 
OATAMGT 
TESTRAN 
CHKPOINT 

GENERATE 



PDS=SYS1.USE 

ACSM£TH=(BOA 
PHASES=( INTE 



GENTYP£={NUC 
UT2SDS=SYS1.UTIL2 

RESNAHE=23 11,RESV 
ASMPRT=ON, LEPRT=( 



R,MEMBERS=NUCID2 

M, ISAM) 

R, EDITOR) ,P AGE S=50,EXEC=200, MODE =TR ACE 

LEUS,2),UT1SDS=SYS1.UTIL1, X 

,UT3S0S=SYSl.UTIL3,0BJP0S=SYSl.a8JECT, X 

0L = SYSTEM,RESTYPE=2311,LB}MAINT=E, X 
LIST,XREF),DIROATA=PDS 



END 



START 



RDR, 1 



Figure 35. Example 1: Input Deck for Nucleus Generation 
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EXAMPLE 2 

This example consists of: 

• Diagram of a machine configuration. 

• Decks for initializing the starter operating system (2314 
distribution) . 

• Decks for initializing direct-access volumes for the new system. 

• Diagram of the volumes that contain generating and new system data 
sets. 

• Deck for initializing new system data sets. 

• Deck for system generation. 

• Decks for system residence on 2303. 

Machine Configuration 

Figure 36 shows the machine configuration used in this example. Only 
those devices on shaded areas are supported by the starter operating 
system. 



154 



IBM SYSTEM/360 MODEL 150 



CHANNEL 



CHANNEL 1 



CHANNEL 2 



1052-7 
PRINTER- 
KEYBOARD 



009 



2821-5 

CONTROL 

UNIT 



2821-5 

CONTROL 

UNIT 



2540-1 
READER 



OOC 



2540-1 
PUNCH 



OOD 



["00 



0! 



2540-1 
READER 



OIA 



2540-1 
PUNCH 



OIB 



1 403 -NT 
PRINTER 



OIF 



1 403 -NT 
PRINTER 



OOF 



I403-N1 
PRINTER 



OOE 



1030 DATA 

COLLECTION 

SYSTEM 



020 



1 050 DATA 

COMMUNICATION 

SYSTEM 



022 



8383 AT a T 
CALLING 

TERMINAL 

[024 



83B3 AT a T 
CALLING 
TERMINAL 



026 



1060 DATA 

COMMUNICATION 

SYSTEM 

f028 



nON _ Z' 



83B3 AT a T 
CALLING 
TERMINAL 



02A 



II5A 
WESTERN UNION 
OUTSTATION 



02C 



I 030 DATA 

COLLECTION 

SYSTEM 



02E 



C 
C 

C 



2702 

TRANSMISSION 

CONTROL 

IBM TERMINAL 
CONTROL- IL 



1 



IBM TERMINAL 
CONTROL- I 



IBM TERMINAL 
CONTROL- I 



IBM TERMINAL 
CONTROL- I 



TELEGRAPH 
TERMINAL CONTROL 



TELEGRAPH 
TERMINAL CONTROL- 1 



3 

>H 
>H 



TELEGRAPH 
TERMINAL CONTROL 



IBM TERMINAL 
CONTROL- I 



^ 



IBM TERMINAL 
CONTROL- I 



/" TELEGRAPH 

V TERMINAL CONTR OL- 1 



C 
C 



TELEGRAPH 
TERMINAL CONTROL 



IBM TERMINAL 
CONTROL- I 



TELEGRAPH 
TERMINAL CONTROL- 



>H 



IBM TERMINAL 
CONTROL- TL 



IBM TERMINAL 
CONTROL- I 



J 



02 



1 050 DATA 

COMMUNICATION 

SYSTEM 



021 



1060 DATA 

COMMUNICATION 

SYSTEM 



023 



II5A 

WESTERN UNION 

OUTSTATION 



025 



1050 DATA 
COMMUNICATION 
SYSTEM^ 

[027 



II5A 
WESTERN UNION 
OUTSTATION 



029 



1060 DATA 

COMMUNICATION 

SYSTEM 



028 



2314 

DIRECT ACCESS 

STORAGE 



1 130-7 



2311 DISK 

STORAGE 

DRIVE 



190 



2841 
STORAGE 
CONTROL 



2803- I 

TAPE 

CONTROL 



2311 DISK 

STORAGE 

DRIVE 



191 




m 



2314 

DIRECT ACCESS 

STORAGE 



230-7 



2303 

DRUM 

STORAGE 



197 



2311 DISK 

STORAGE 

DRIVE 



|I92 



2311 DISK 

STORAGE 

DRtV£ 



291 



2848-3 

DISPLAY 

CONTROL UNIT 



2F 



2260-1 
DISPLAY 

UNIT^ 

[JFO 



2841 
STORAGE 
CONTROL 



29 



2311 DISK 

STORAGE 

DRIVE 



292 



1053-4 
PRINTER 



|2F4 



2260-1 
DISPLAY 

UNIT^ 

|2FT 



2311 DISK 
STORAGE 
DRIVE 

1 294 



2311 DISK 

STORAGE 

DRIVE 

1 293 



1030 DATA 

COLLECTION 

SYSTEM 



02D 



2803-1 

TAPE 

CONTROL 



Figure 36. Example 2: Machine Configuration 
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CHANNEL 2 



CHANNEL 3 



2848-3 

DISPLAY 

CONTROL UNIT 



2260-1 

DISPLAY 

UNIT 



2F0 



29 



1053-4 
PRINTER 



|2F4 



2260-1 

DISPLAY 

UNIT 



2FI 



2311 DISK 

STORAGE 

DRIVE 



294 



293 



2803-1 

TAPE 

CONTROL 



2816-1 

SWITCHING 

UNIT 






2803-1 

TAPE 
CONTROL 



2841 
STORAGE 
CONTROL 




2250-2 

DISPLAY 

UNIT 



3AI 



2250-1 

DISPLAY 

UNIT 



3E0 



2840- I 

DISPLAY 

CONTROL UNIT 



3A 



2250-2 

DISPLAY 

UNIT 

|3A2 



2282 FILM 

RECORDER/ 

SCANNER 



3A4 



c 



2701 DATA 
ADAPTER UNIT 

IBM TERMINAL 

ADAPTER- nr 






c 



IBM TERMINAL 
ADAPTER-M 



>- 



2848 
DISPLAY 
CONTROL 

UNIT 



2260-1 

DISPLAY 

UNIT 



2848 
DISPLAY 
CONTROL 

UNIT 



2260-1 

DISPLAY 

UNIT 



Decks for Initializing the Starter Operating System 

Four decks are required to initialize the 2314 distribution of the 
starter system. 

Figure 37 shows the IBCDASDI deck for initializing the volume that is 
to contain DLIBOl. The serial number of the volume is NNNNNN. This 
volume is being initialized for the first time. This volume resides on 
unit 130. The distribution tape (DLIBOl) resides on unit 280. The 
DASDI deck is placed on the 25U0-1 card reader at unit OOC. Messages 
will be printed on the 1403-N1 printer at unit OOE. 



DLIBOl JOB 

MSG TODEV=1U03,TOADDR=OOE 

DADEF TODEV=2314 ,TOADDR=130 , VOLID=SCRATCH, 

FLAGTEST=NO 

VLD NEWVOLID=NNNNNN , 0W]SIERID=DEPTD5 8 

VTOCD STRTADR=5 , EXTENT=1 
END 

Figure 37. Example 2: Initializing Volume for DLIBOl 



Figure 3 8 shows the IBCDMPRS deck for restoring DLIBOl to volume 
NNNNNN. This deck is placed on unit OOC. 



RESTORE JOB 

MSG TODEV=1403,TOADDR=00E 

RESTORE FROMDEV=24 00 ,FROMADDR-280,TODEV=2314, 
TOADDR=130 , VOLID=NNNNNN 

END 

Figure 38. Example 2: Restoring DLIBOl 

After executing the IBCDMPRS program, the volume on unit 130 is now 
DLIBOl- The tape on unit 28 should be removed and stored in the tape 
library as a backup for the starter system. 

After IPL, DLIBOl is ready for operations. The programs in Figure 39 
and 40 operate under the starter system. 

Figure 39 shows the deck for punching the contents of SYSl.SAMPLIB. 
In addition to the independent utility programs, the sample programs for 
FORTRAN G, PL/I, and sort/merge are punched. 
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//PUNCH JOB MSGLEVEL=1 -PUNCH SYSl . SAMPLIB- 

// EXEC PGM=IEBPTPCH 

//SYSUTl DD DSNAME=SYS1. SA1^PLIB,DISP= (OLD, KEEP) , 

// UNIT=231U,VOLUME=SER=DLIB01 

//SYSUT2 DD UNIT=2540-2 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD * 

PUNCxi TYPORG=PO , MAXNA]yiE=7 

ME]y!BERNAiyiE= IBCDMPRS 

MEMBSRNAFjE^IBCDASDI 

MEMBERNAiME= IBCRCVRP 

ME' MB£RNAME= IE AI PLO 

MEMBERNAME= lEYSP 

ME MBERNAi>ffi= lEMS P 2 

MEMBERNAiyiE= lERSP 

Figure 39. Example 2: Punching Members of SYSl.SAMPLIB 

After these seven decks are punched, the first card (member name 
card) of each deck must be removed. 

Figure 40 shows the deck for listing the system data describing the 
starter system's SYSl. NUCLEUS, SYSl.SAMPLIB, and SYSl.PROCLIB. 



r 

//LIST JOB MSGLEVEL=1 
// EXEC PGM=IEHLIST 
//SYSPRINT DD SYSOUT=A 

//DDl DD UNIT=2314,DISP=OLD,VOLUME=SER=DLIB01 
//SYS IN DD * 
LISTCTLG 
LISTVTOC DUMP 

LISTPDS DSNAME= (SYSl . NUCLEUS , SYS 1 . PROCLIB , 
SYSl.SAMPLIB) 
/* 
L_ J 

Figure 40. Example 2: Listing Data in DLIBOl 

Initializing Volumes for New System 

The volumes for the new system must be initialized before system 
generation. Five volumes (besides DLIBOl) will be used. Their serial 
numbers will be MVTlll, MVT222, MVT333, MVT444, and MVT555. These 
volumes are mounted on units 131, 230, 231, 232, and 132, respectively. 
MVTlll is to be the new system residence volume. It is assumed that all 
these volumes had been initialized before. 

Figure 41 shows five IBCDASDI input decks for initializing the new 
volumes. The deck for MVTlll contains the IPL program (lEAIPLOO). The 
IPL cards were obtained from SYSl.SAMPLIB (see Figure 39). 

The IBCDASDI object program cards must be placed in the card reader 
on unit OOC and loaded into main storage. The input decks in Figure 41 
are placed in the card reader immediately following the IBCDASDI object 
program deck. (For further details on the operating procedure for 
IBCDASDI, refer to the publication IBM Svstem/360 Operating System; 
Utilities . ) 
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MVTlll JOB 
MSG 
DADEF 
VLD 
VTOCD 
IPLTXT 



TODEV=1U03,TOADDR=OOE 

TODEV=231U , T0ADDR=131 , IPL=YES , VOLID= SCRATCH 

NEWVOLID=MVTlll , OWNERID=DEPTD58 

STRTADR=2 , EXTENT=8 



lEAIPLOO cards 



.END 

MVT222 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT333 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT444 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT555 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 



T0DEV=1 4 3 , TOADDR= E 
TODEV=231U , TOADDR=230 , VOLID=SCRATCH 
NEWVOLID=MVT222 , OWNERID=DEPTD58 
STRTADR=2 , EXTENT=8 



TODEV=1403,TOADDR=00E 

TODEV=231U , TOADDR=231 , VOLID=SCRATCH 
NEWVOLID=MVT333 , OWNERID=DEPTD58 
STRTADR=2 , EXTENT=8 



TODEV=1403,TOADDR=00E 

TODEV=2314,TOADDR=232,VOLID=SCRATCH 
NEWVOLID=MVT 4 4 U , 0WNERID=DEPTD5 8 
STRTADR=2 , EXTENT=8 



TODEV=1U03,TOADDR=OOE 
TODEV=2314 , TOADDR=132 , VOLID=SCRATCH 
NEWVOLID=MVT555 , OWNERID=DEPTD58 
STRTADR=2 , EXTENT=8 



Figure 41. Example 2: Initializing New System Volumes 
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Volumes Used for Sys-tem Generation 

Figure 42 shows the volumes that contain the generating and new 
system data sets. The serial number of the generating system residence 
volume is DLIBOl. The serial number of the new system residence volume 
is MVTlll. Volumes MVT222, MVT333, and MVT4U4 contain the remaining new 
system data sets. The four utility data sets used during system 
generation are named SYSl.SGOBJ, SYSl.SGl, SYS1.SG2, and SYS1.SG3. 



DL(B01 

3^1. SYSJOJg^ 
jV SI. SVCLJg ^ 
>jV S1. LlNKU g. 

^gV SCTLG 

JV SI. PROCU g. 
JV S1. SORTL ig^ 
jY Sl COBUjB ^ 
jY SI. FQRTU g^ 

jY SI. NUCLg Ug. 
^§Y St LOGRg S^ 
.§YS1_GENLJB 
^§Y S1. MACU B. 
4V S1 MQPU g- 




gVSUjNKjJg., 

SY S1. SYSVL Q^ 

^^§YS1^_SYSVL0§>' 

§VS 1,562 ^.^ 



jY SCTLG 

^1. NUCLg US. 

^§ YS1. LOGRg g 

^1.SG1 . 



MVT555 



MVT 333 

S YSI.SYSJ Ogg^ 
-§VSl.se3 




-§Y S1. PROCU g, 
^YSlMACUa^ 

-^VstCOBUg^ 
■jV Sl. SORTU g^ 
.■g^ g.1. PULig ^^ 
.§V Sl FORTL ig^ 
-gVSl. ALGLjg 



Figure 42. Example 2: Generating and New System Volumes (2314) 
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Initializing New System Data Sets 

Figure 43 shows the input deck for initializing the new system data 
sets. During this initialization, volumes DLIBOl, MVTlll, MVT222, 
MVT333, and MVT4U4 must be mounted. The configuration used in this 
example (Figure 36) allows the simultaneous m.ounting of all six volumes 
(Figure 42) involved in this generation. Therefore, to simplify 
operating procedures, all six volumes should be mounted at this point. 
It is assumed that there is no dependency on device addresses, and that 
the volumes can be mounted on any 2314 drive. For illustrative purposes 
assume that volumes DLIBOl, MVTlll, and MVT555 are mounted on drives 
130, 131, and 132; and that volumes MVT222, MVT333, and MVT444 are 
mounted on drive 230, 231, and 232, respectively. 
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//SYSGEN 

//STEP 

//SYSPRINF 

//SVCLIB 

tf 

// 

//CATALOG 

// 

// 

//NUCLEUS 

// 

// 

//LINKLIB 

// 

// 

//LOGX 

// 

// 

//LOGY 

// 

// 

//JOBQE 

// 

//PR0CLI8 

// 

// 

//MACLI8 

// 

// 

//TELCLIB 

// 

// 

//COBLIB 

// 

// 

//SOKFLIB 

// 

// 

//PLILIB 

// 

// 

//FOKTLIB 

// 

// 

//ALGLI8 

// 

// 

//SYSIN 

CATLG 
CAFLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 



JOB MSGLEVEL= 

EXEC PGM=IEHPR 

DO SYSOUT=A 

DO OSNAME=SYS 
UNIT=2314, 
LA8EL=£XPD 

DO DSNAME=SYS 
UNIT=2314, 
LABEL=EXPO 

DD DSNAME=SYS 
UNir=2314, 
LABEL=EXPD 

00 DSNAME=SYS 
UNIT=23l4t 
LABEL=eXPO 

DO DSIMAME=SYS 
UNIT=2314, 
LABEL=EXPD 

DD DSNAHE=SYS 
UNIT=23i4, 
LABEL=EXPD 

DO DSNAME=SyS 
UNIT=2 314, 

DO OSNAME=SYS 
UNIT=2314t 
LABEL=EXPD 

DD OSNAME=SYS 
UNIT=2314, 
LABEL=EXPO 

DO DSNAME=SYS 
UNIT=23L4, 
LABEL=£XPO 

DO OSNAmE=SYS 
UNI r= 2314, 
LABEL=EXPO 

DO DSNAHE=SYS 
UNIT=2314, 
LA8EL=EXPU 

OD DSNAME=SYS 
UNIT=2314, 
LAB£L=EXPO 

DD OSNAME=SYS 
UNI T= 2314, 
LABEL=EXPD 

00 OSNAME=SYS 
UN I T= 23 14, 
LABEL=EXPD 



00 



CVOL=2314=MV 
CV0L=2314=MV 
CV0L=2314=HV 
CV0L=2314=MV 
CV0L=2314=MV 
CVOL=2314=MV 
CVOL=2314=MV 
CV0L=2314=MV 
CV0L=2314=HV 
CV0L=2314=MV 
CV0L = 23i4=*^iV 
CV0L=23l4=f-^V 
CV0L=2314=MV 



1 

OGM 

i,.SVCLI 
DISP=(, 
T=99350 
CTLGfVO 
01SP=(, 
T=99350 
l.NUCLE 
OISP=(, 
T- 99 3 50 
l.LINKL 
OISP=(, 
T =99 3 50 
l.SYSVL 
DISP=(t 
r=99350 
l.SYSVL 
OISP={, 
T=99350 
l.SYSJO 
OISP=(, 
l.PROCL 
DISP={, 
T=99350 
l.MACLI 
OISP=(, 
T=99 350 
I.TEL CM 
UISP=(, 
T=99350 
l.COBLI 
OISP=i, 
T=99350 
l.SORTL 
DISP=(, 
T=99350 
I.PLILI 
OISP=( , 
T=99350 
l.FURTL 
1 S P = { , 
1=99350 
l.ALGLI 
OISP={, 
1=99350 
-IN 
TtlltVO 
U11,V0 
T11I,V0 
Tlll,VO 
T 1 1 1 , VO 
1 1 II , VU 

TiiifVn 

Tlll,VO 
T 1 1 1 , VO 
M11,V0 
T11I,V0 
11 1 1 , VO 
TUltVO 



-EXAMPLE 2- 
-ALLOCATE ON 2314- 

6, VOLUM£={ , RETAIN, SER=MVTlll) , 
KEEP),SPACE=(TRK,(130,,75), ,CONriG), 
, DC8 =( DSORG=POU,R£CFH=U,BLKS I ZE= 1024 
LUME=(,RETAIN,SER=MVTlll) , 
KEEP), SPACE=(TRK, (6,1)) , 

US,VOLUME=C ,RETAIN,SER=MVTlll), 
KEEP),SPACE={TRK,(20, ,1) ,,CaNTIG) , 

IB,VOLUME=( , RETAIN, SER=MVT222), 
KEEP) ,SPACE=(TRK,(850,,100) ,,CQNTIG) 
,DCB = iRECFM=U,BLH;SIZE=7294) 
OGX,VOLUME=l, RETAIN, SER=HVT222) , 
KEEP),SPACE=( 120,(100), ,CONTrG), 

OGY,VOLUME=C,RETAIN,SER=MVT222) , 
KEEP) ,SPACE=l 120,(100) ,,CONTIG) , 

BQE, VOLUME =( , RETAI N, SER=MVT33 3) , 
KEEP),SPACE=(TRK,(200),,C0NTIG) 
iB,VOLUME={ , RETAIN, SER=MVT444) , 
KEEP),SPACE=(TRK,(20,6,9) ) , 
,0CB = {RECFM=F,BLKSI/.E = 80) 
B,V0LUME=( , RETAIN, SER=MVT444) , 
KEEP),SPACE=(TRK,(300,30,25) ) , 
,DCB=(RECFH=FB,8LKSIZe=72 80,LRECL=80 
LIB,V0LUME=(,RETAIN,SER=MVT44 4) , 
KEEP) , SPACE=(TRK,(30,2,10) ) , 
,DCB=(RECFM=U,8LKSIZE=7294) 
B,VOLUME=( , RETAIN, SER=MVT444) , 
KEEP) ,SPAC£ = (TRK,(25,1,30) ) , 
,DCB={RECFN=U,BLKSIZE=7294) 
IB,VULUM£=( , RETAIN, SER=HVT444) , 
KEEP) ,SPACE=(TRK, (40, 1,40) ) , ' 
,DCB=(RECFM=U,BLKSIZ£=7294) 
B,VOLUHE=( , RETAIN, SER=HVT444) , 
KEEP) , SP AC E=(TRK, (55,2,65) ) , 
,0CB = iR£CF>M=U,8LKSIZE = 72 94) 
IB,VOLUME={ ,RETAIN,SER=MVT444), 
KEEP) ,SPACE=(TRK,<25,1,40) ) , 
,0CB = {RECF!^=U,8LKSIZE = 7294) 
B,VULUiME = { , RETAIN, SER=MVT444) , 
KEEP),SPACE=(TRK,(26,2,15) ) , 
,0C8 = (RECFiM=U,8LKSIZE = 72 94) 
PUT FOR CATALOGING SYSTEM DATA SETS- 
L= 23 14=MVT222,0SNAME= SYS I. LINKLIB 
L=2314=MVT111,DSNAME=SYS1. SVCLIB 
L=23 14=HVT333,0SNAME=SYS1. SYS JOBQE 
L=2314=MVT444,DSNAME=SYSl.PRnCLI8 
L=23 14 = M VT 444, 0SNA)M£ = SYS l.MACLI 8 
L=2314=MVT444,0SNAM£=SYSl.TELCMLIB 
L=2314=MVT444,0SNAME=SYS1.C0BLIB 
L=2314=HVT444,DSNAME= SYS l.SORTL IB 
L=2314=MVT444,0SNAME=SYSl. PLILIB 
L=2314=iMVT444,0SNAME=SYSl.F0RTLIB 
L=2314=HVT444,0SNAME=SYS1.ALGLIB 
L=2314=MVT222,0SNAME=SYS1.SYSVL0GX 
L = 2314=iMVT222,0SNAME=SYSl.SYSVL0GY 



Figure 43. Example 2: Initializing New System Data Sets (2314) 
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Input Deck for Stage I 

Figure 44 shows the input deck for system generation. The utility 
data sets are allocated space on the volumes indicated in Figure 42. 
The job stream will be written on an unlabeled magnetic tape that 
resides on drive 182 (see Figure 36). Stage II will be started 
automatically after Stage I is completed. Generic unit names are used. 

The new system supports all devices in Figure 36. Multiprogramming 
with a variable number of tasks (MVT) is used. All access methods and 
optional system data sets are generated. Assembler F, linkage editor 
E44, TESTRAN, sort/merge, ALGOL, COBOL F, FORTRAN G, PL/I F, -and RPG are 
included in the new system. All standard default options are selected 
for the processors. 

After Stage II has terminated, SYSl.SGl, SYS1.SG2, and SYS1.SG3 can 
be scratched and uncataloged. The job stream and SYSl.SGOBJ should be 
saved. DLIBOl can be removed. A backup copy of the new system should 
be made. The new system is ready to operate after initial program load 
(IPL) . 



Examples 163 



//STEPl EXEC PGM=ASM8LR -STAGE I INPUT- 

//SYSLIB DO 0SNAMe=SYSl.GENLI6,DISP=0LD 

//UBJPDS DO OSNAiMfc=SYS l.SGOBJ,VOLUME = (, RETAIN, SER = MVT555) , 

// DISP=< ,CATLG),UNIT=2314,SPACE = ( TRK , ( 32 , 10 ,8) ) 

//SYSUTl OD DSNAME=SYS1. SGI, VOLUHE = {, RETAIN, SER=.MVTlll) , 

// DISP={,CATL6),UNIT=2314,SPACE-=(TRK,<160,10)) 

//SYSUT2 DO USNAME=SYS l.SG2,V0LUME=(, RETAIN, SER=MVT222) , 

// OISP=( ,CATLG),UNIT=23I4,SPACE=(TRK,( 160,10)) 

//SYSUT3 00 0SNAME=SYSi.SG3,V0LUM£={, RETAIN, SER=MVT333), 

// DISP=( ,CATLG)tUNI T= 23 14, SPACE=C TRK, C 200, 10) ) 

//DUMMY DO V0LUMfc=(,KETAIN,REF=*.SYSUT3),SPACE=(TRK,(60) ) 

//SYSPUNCH DO UNIT=lB2,LA8eL=( ,NL) 
//SYSPRINT DO SYSOUT=A 
//SYS IN DO * 

CENPROCS M0DEL=5G,ST0RAGe=I,FEATURE=PR0TECT 
,MPX CHANNEL ADORE SS = 0, T YPE = MULT IPLE XOR 

CONSOLE lODEVICE UN I T= 1052, MO 0EL = 7, ADDRESS = 009 

CNTOO lOCONTRL UN I T = 2821 , MO DEL = 5 , ADORE SS = 00 ,FEATURE = CnL8NRY , 

TRNMODE=BYTE 
DEVOOC inOEVICE UNI T= 2540H , MODEL =1 , A00RESS=00C 

OEVOOO lODEVICE UN I T = 2540P , MODEL =1 , ADORES S=00D 

OEVOOfc lOOEVICE UN I T = 1 403, MO DeL = Nl , ADORES S=OOE 

OEVOOF lODEVICE UN I T= 1403, MO DEL = N1 , ADDRESS=OOF 

CNTOl lOCONTRL UNI T= 2821 , M0 0fcL=5 , AODRE SS=01 ,FEATURE=COLBNRY , 

TRNMOOE=BYTE 
OEVOIA lODEVICE UN i T= 2540R , MODEL =1 , ADDRESS=01A 

OEVOIB lODEVICE UN I T = 2540P , MODEL =1 , ADORE SS=01B 

DEVOIF lOOEVICE UN I T= 1403, MO DEL = N1 , ADORE SS=01F 

CNT02 lOCONTRL UN IT= 2702, ADORES S=02 

L INt020 lODEV ICE UNIT= 1030, A00RESS = 020, AOAP TER= I 8M2 ,SETADDR=2, 

FEArURE=AUTOPOLL 
LINED 2 1 lODEVICE UN I T= 1050 , AD OR ES S = 02 1 , ADAP TER= I BM 1 ,S ETA00R= 1 , 

FEATURE=AUTOPOLL 
L I NEO 22 i OOEV ICE UN I T= 10 50 , AD OR E S S = 02 2 , ADAP T£R= I BM 1 , SE TA00R= 1 , 

FEATURF=AUTUPOLL 
L iNE023 inOEV ICE UNIT= 1060, A0ORESS=023 , ADA PTER= I BMl ,SETAD0R=1 , 

FEATURE=AUTUPOLL 
LI NEO 24 lOOEVICE UN I T = 836 3, ADORES S=024 , ADA PTER= TELEl , SET ADDR = 3 

LINE025 lOOEVICE UN I T= 11 5A , AD ORES S = 025, ADAPTER= TELEl , SETAD0R = 3 

LINE026 lOOEVICE UN I T = 83B 3, ADORES S =026 , ADAP TER= TE LEI ,SETA0DR = 3 

L INE027 lODEV [CE UN I T = 1050, AO OR ES S = 02 7 , ADAPTER= I BHl , S£TAOOR= 1 , 

FEATURE=AU70POLL 
LINE028 ILjOEVICE UN IT = 1060 , ADORES S=02 8, ADAPTER= I BHl , S£TA0DR= 1 , 

FEArURE=AUTOPOLL 
L I NE029 I OOEV ICE UN IT= 1 1 5 A , AD OR E S S = 02 9 , ADA P TER= TE LE 1 , SE f AODR = 3 

LINE02A lOOEVICE UN I T = 838 3, AOURES S = 02 A , ADAPTER=TE LEI , SET ADDR = 3 

LINE02B lOOEVICE UNIT= 1060 , AD0RESS = 02B , AOAPTER=I BH 1 , SETAOOR= 1 , 

FEATURE=AUTOPOLL 
L I NE 02C lOOEVICE UN£T=1 15 A , ADORES S=0 2C , A0APTER = TELE1 ,SETAD0R=3 

LINE020 lODEVICE UNIT= 1030, ADDRESS = 020, ADAPT£R=I 8M2 , SETADDR=2 , 

FEATURE=AUTOPnLL 
LINE02E lOOEVICE UNIT= 1030, AD OR ES S = 02E , ADAPTER= I BM2 , SETA0DR=2 , 

FEArURE=AUTnPOLL 
CHI CHANNEL AUDR£SS= 1, T YP£= SELEC TOR 

0EV130 lODEVICE UN I T = 231 4, ADDRESS = 130 

CNT18 lOCONTRL UNI T= 2803 , MO OEL= I , ADORE SS= 18 , 

FFATURE={ DATACUNV ,7-TRACK) 
DEVI 80 lOOEVICE UN I T = 240 2 , M0DEL = 3 , ADORE SS=180 , FEATURE = 7-TRACK 

DEVI 81 lOOEVICE UN I T = 2402, MO DEL = 3 , ADDRESS= 18 1 , FEATURE = 7-TRACK 

DEVI 82 lODEVICE UN I T = 2402 ,MO0EL = 3 , ADORE SS= 182, FE ATUR£ = 9-TRACK 

DEVI 83 UiOEVlCE UN 1 1 = 240 2 , MODE L = 3 , ADORE SS = 183, FE ATUR£ = 9-TRACK 



Figure 44. Example 2: Input Deck for Stage I (Part 1 of 3) 
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CNT19 lOCONTRL UN IT= 2841, AD0RESS=I9 

DEV190 lOOEVICE UN IT=231 1, AO0RESS=190 

UtV19l lODEVICE UNIT=23ll,ADURESS=l91 

0EV192 lOOEVICE UN IT= 231 1 , ADDRESS=192 

DEV193 lODEVICE UN IT= 2303, ADDRESS=193 

CH2 CHANNEL A00RESS=2,TYPE= SELECTOR 

DEV230 lOOEVICE UN I T= 231 4, ADORES S=230 

CNT28 lOCONTRL UN IT= 280 3,M0 OEL= 1 , AODRE SS=28, X 

FEATURE=( OATACONV ,7-TRACK) 
0EVX80 lODEVICE UN IT=2402,H00EL=3, ADDRESS=280 ,FEATURE=7-TRACK, X 

0PTCHAN=3 
OfcVXBl lOOEVICE UNIT=2402,MODEL=3^AU0RESS=28l,FEATURE=7-TRACK, X 

0PTCHAN=3 
DEVX82 lOOEVICE UN I T= 2402 ,MO0EL=3, ADORE SS=282 ,FE ATURE=9-TRACK , X 

UPTCHAN=3 
0EVX83 lUDEVICE UN IT=2402 , MO DEL=3 , AD0R£SS=283 ,FE ATURE=9-TRACK , X 

nPTCHAN=3 
DEVX84 lOOEVICE UN I T = 240 1, M0DEL = 3, AD0RESS=284,FE ATURE=9-TRACK, X 

0PTCHAN=3 
DEVX85 lOOEVICE UN IT= 240 1 ,M0 CEL=3 , ADDRESS=28 5 ,FEATURE=9-TRACK, X 

0PTCHAN=3 
DEVX86 lOOEVICE UNIT =2401 , MO DEL=3, ADORE SS=286 ,FEATURE=9-TRAC K, X 

0PTCHAN=3 
0EVX87 lOOEVICE UN I T = 240 I, M0DEL=3 , ADDRESS=287 , FE ATURE=9-TRACK, X 

0PTCHAN=3 
CNT29 lOCONTRL UN IT= 2841, A00RfcSS=29 

CNT291 lOOEVICE UN I T = 231 1, AUDRESS=291 

CNT292 lOOEVICE UN I T= 231 1 , A0URESS=292 

CNT293 lODEVICt UN IT= 231 1 , ADORES S=293 

CNT294 lOOEVICE UN I T= 231 1, AD ORES S = 294 

CNT2F lOCONTRL UN I T = 2848,M0 0EL = 3, ADDRE SS=2F ,FE ATURE = NODESCUR 

DEV2F0 lOOEVICE UN I T = 2260, HODEL= I , ADDRE SS=2F0 ,FEATURE = ALKYB2260 

0EV2F1 lODEVICE UN I T = 2 260, MODEL= 1 , AODRE SS=2F I ,FE ATURE=NMKYB2 260 

DEV2F4 lOOEVICE UN I T = 1053,HOOEL=4 , A0DRESS = 2F4 

CH3 CHANNEL ADORESS= 3, TYPE= SELEC TOR 

CNT3B lOCONTRL UNI T= 2803, HOOEL=l , A00RESS=38 , X 

FEATURE=( OATACONV ,7-TRACK) 
CNT32 lOCimTRL UN I T = 2841 , ADORES S=32 

DEV320 lODEVICE UN iT= 2302, M00EL=3, ADORE SS=320 

0EV321 lOOEVICE UN I T = 2302 , M0 0EL = 3, AD0RESS = 32 1 

CNT35 lOCONTRL UNI T= 270 1 , AD 0RESS=35 

0EV351 lODEVICE UN IT= 2260 , MODEL= 1 , FE ATURE = ALKY82260 , AOAP f ER= I BH3 , X 

ADDRESS=35I 
DEV355 lODEVICE UN I T = 2260,M0 OEL= 1 , FE ATUR£ = ALKYB2260 , ADAPTER= I BM3 , X 

ADDRESS =35 5 
CNT3A lOCONTRL UN I T= 2840, MO DEL = 1 , ADDR£SS=3A 

0EV3A1 lUDEVICE UN I T = 2250, H0D£L = 2 1 ADDRE SS = 3A 1 ,NUMSECT = 5 , X 

FEATURE={ALKYB2 25 0,LIGHTPEN,PRGMKY80) 
OEV3A2 lOOEVICE UN IT= 2250, H00EL=2, ADDRE SS=3A2 ,NUMSECT=5 , X 

FEATURt={ ALKY82 25 0,LIGHTP£N,PRGMKYBD) 
DEV3A4 lODEVICE UN IT= 2282 , AOURES S=3A4 , NUMSEC T=5 

DEV3E0 lODEVICE UN i T= 2250, HO DtL=l , ADORE SS=2E0 , X 

FEATUHE={ ALKYB225 0,6UFFER8K,LIGHTPEN,0ESIGNF£AT) 
UNITNAHE UNIT=( 180, 18 1, 182, 18 3,280,281,282 , 283 ,291 , 292 , 293) , X 

NAME=SYSSQ 
UNITNAME UNIT=(190, 19 1, 192, 193, 291 , 292 , 293 , 294 ,235 ,2 36, 237 ), X 

NAME=SYSOA 
UNITNAHE UNIT=OOD,NA)Mt=SYSCP 

UNITNAME UNIT= (282,28 3,284,285,286,287) ,NAME=TAPE 
UNITNAHE UNIT= (320, 32 U , NAME=RECOROS 
UNITNAME UNIT= ( 134, 135,136, 137, 234,235,236,2 37) ,NAME=FIL£ 



Figure 44. Example 2: Input Deck for Stage I (Part 2 of 3) 
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CTRLPROG rYPE=?'VT,MAX 10=6 1 , QSPACE=20, A00TRAN=4 

SCHEDULE TYPE=PRIORITY.,CONSOLE=009,ALTCONS = (I-OOC»0-OOF), X 

OPTIONS=BYLABEL,STARTR=A-0OD,STARTW=A-00E, X 

ACCTRTN=SUPPLI60, STARTI=AUTO, WTL8FRS=l0f PROCRES=232 , X 

JU8gRES=231,INITQ8F=l0,MINPART=54 
SUPRVSOR RESIDNT=(8L0LTAB,RENTC0DE,TRSVC) ,TRACE=100, X 

OPT IONS = (PH0TECT,C0MM»,TIMER=J08STEP,SER=SER1 
PROCLIB UNIT=2314,V0LNU=MVT444 
OATAMGT ACSMtTH=(8DAM, ISAM,BTAM,QTAM) 
FELCMLIB yNIT=2314,V0LN0=MVT444 
GRAPHICS 

EDITOR 0ESIGN=E44 

ASSEMBLR OESIGN=F 

TESTRAN PHASES=( INTERfEO ITOR > ,MOD£=TRACE , PAGES = 20 ,EXEC=200 
MACLIB UNIT=2314,V0LN0=MVT444 

CHKPOINT 

SORTMERG S IZE= 24000, SORTOPT=FULL IB 
SORTLIB UNIT=23I4,V0LN0=MVT444 
ALGOL 

ALGLIB UNIT=23I4,V0LN0=MVT444 

COBOL DESIGN=F 

C08LIB 0ESIGN=F,UNIT=23I4, V0LN0=MVT444 

FORTRAN DESIGN=G 

F0RTLI8 DESIGN=G,UNI T=23 14, V0LN0=MVT444 
PL I OESIGN=F 

PL1LI8 UNIT=2314,V0LN0=MVT444,LIBFCNS=C0MPLEX 

RPG 
GENERATE UT ISO S=SYS 1 . SGI, UT2SDS=SYS1. SG2,UT3S0S=SySl . SG3, X 

0BJPDS=SYSl.SG0BJ,RESNAME=2314,RESV0L=MVTlll, X 

RESTYPE=23 14,LNKNAME=2314,LNKV0L=MVT222,L8MAINT=E, X 

ASHPRT=ON,DIROATA=PDS,LEPRT=(LIST,XREF) 
END 



// START RDR,182 



Figure 44. Example 2: Input Deck for Stage I (Part 3 of 3) 

Decks for System Residence on 2303 

The 2303 unit at address 197 (see Figure 36) can be used for system 
residence instead of volume MVTlll. The IBCDASDI deck in Figure 45 must 
replace the deck MVTlll in Figure 41. The serial number of the 2303 
volume is SYSRES. 

r 1 

SYSRES JOB 

MSG TODEV=1403,TOADDR=00E 

DADEF TODEV=2303 ,TOADDR=197, IPL=YES, VOLID=SCRATCH 

VLD NEWVOLID=SYSRES, OWNERID=DEPTD58 

VTOCD STRTADR=2 , EXTENT=8 

IPLTXT 

. [ lEAIPLOO cards 

.END 

Figure 45. Example 2: IBCDASDI Deck for 2303 

The DD statements in Figure 46 must replace the DD statements for 
SYSl.SVCLIB, SYSCTLG, and SYSl. NUCLEUS in Figure 43. The CATLG state- 
ments replace all the CATLG statements in Figure 43. 

Only two changes must be made to the Stage I input deck in Figure 44: 
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• The SYSl.SGl utility data set must be allocated space on SYSRES 
rather than on MVTlll as follows: 



//SYSUTl DD DSNAME=SYS1 . SGl , VOLUME= ( , RETAIN, SER=SYSRES) , 
// DISP=(,CATLG) ,UNIT=2303,SPACE=(TRK, (180,16)) 



X 



• The RESNAME, RESVOL, and RESTYPE parameters of the GENERATE macro 
instruction must be coded as follows : 

RESNAME=2303,RESVOL=SYSRES,RESTYPE=2303 



//SVCLIB 

// 

U 

//CATALOG 

// 

// 

//NUCLEUS 

// 

// 



//SYSIN 

CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 



DO 0SNAHE=SYS1. SVCLIB, VULUME=(RETAIN, SER=SYSRES) , X 

UNIT=2 30 3,CISP=(,KfcEP),SPACE=(TRK,il20,,75) , ,COIMTIG) t K 
L ABEL= EXP D T=993 50, 0CB={0SaRG=P0U,RECFM=U,8LK SIZE =1024) 

DO OSNAiME=SYSCTLG,VOLU.ME = ( , RETAIN, SER=SYSRES) , X 

UNIT=2 303,DISP=(,KEEP) , SP AC£= ( TRK , ( 8 , U ) , X 
LABEL=EXPDT=99350 

00 OSNAME=SYSUNUCLEUS,VOLUME = ( , RETAIN, SER=SYSR£S) , X 

UNIT=230 3,DISP=1,KE£P),SPACE=CTRK,(25, , I ) , ,CONTI G ) , X 
LABEL=EXPOT=99350 



DO * 
CVOL^ 
CVOL: 
CVOL^ 
CVOL^ 
CVOL^ 
CVOL = 
CVOL^ 
CVOL = 
CVOL = 

cvaL = 

CVOL^ 
CVOL = 
CVOL = 



^2303^ 
2303^ 
230 3^ 

^2303^ 
2303^ 
2303^ 

^2303^ 
2303 
2303 = 

^2303^ 

^230 3= 
2303^ 
2303 



=SYSRES, 
= SYSRES, 
= SYSR£S, 
= SYSRES, 
=SYSRES, 
= SYSRES, 
^SYSRES, 
= SYSRES, 
= SYSRES, 
:SYSRfcS, 
=SYSRES, 
= SYSRES, 
= SYSRES, 



INPU 
ViJL= 
VOL = 
V(JL = 
VOL= 
VOL= 
VOL= 

vnL= 

VOL= 
VOL= 
VOL= 
VOL= 
VOL= 
VOL = 



T FOR 
2314 = 
2314 = 
2303 = 
2314 = 
2314= 
2314= 
2314= 
2314= 
2314 = 
2314 = 
2314= 
2314= 
2314= 



CATALO 
HVT333, 
MVT222, 
SYSRES, 
HVT444, 
MVT444, 
MVT444, 
MVT444, 
MVT444, 
MVT444, 
HVT444, 
HVT444, 
MVT22 2, 
MVT222, 



GING SY 
DSNAME= 
OSNAM£= 
DSNAME= 
DSNAHE= 
OSNAM£= 
OSNAH£= 
OSNAHE= 
OSNAHE= 
OSNAME= 
OSNAME= 
DSNAME= 
OSNAME= 
DSNAME= 



STEM 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 
SYSl 



DATA SETS- 
.SYSJOBQE 
. L I NKL I 8 
.SVCLIB 
•PROCLIfi 
.MACLIB 
•TELCMLIB 
.C0BLI8 
.SQRTLI8 
.PLILI8 
.FORTLIB 
.ALGLIB 
. SYSVLOGX 
. SYSVLOGY 



Figure 46. Example 2: Allocation on 2303 
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APPENDIX A: SYSTEM GENERATION MESSAGES 



System generation messages are produced 
by the assembler program during the expan- 
sion of system generation macro- 
instructions. These messages are printed 
in the assembler listing in the SYSPRINT 
data set. Two types of messages are pro- 
duced : error messages and informative 
messages. 

ERROR MESSAGES 

Table 7 shows the message code and 
format of system generation error messages. 
The messages follow. 



lEIaaannn text 

Explanation; The error indicated by 
the message text is a coding error in 
the system generation macro- 
instruction, aaa. The message serial 
number, nnn, identifies the message. 



sage IEIGEN113 or IEIGEN116 was 
printed, followed by the message: 
GENERATION TERMINATED. Then the sys- 
tem generation process was abnormally 
terminated. 

Severity Code; 5 

User Response; Correct the error or 
errors indicated and begin the system 
generation process from the start of 
Stage I. 



IEIGEN113 QUIT SWITCH 
MACRO 



ON BEFORE GENERATE 



Explanation; One or more errors, 
indicated by messages, were detected 
before the GENERATE macro-instruction 
was expanded. 

Severity Code; 7 



For the CHANNEL, lOCONTRL, and lODE- 
VICE macro-instructions, the message 
text begins with either the name field 
of the macro-instruction or, if the 
name field was omitted, the sequential 
identification number provided by the 
system. 

Examples of these messages are: 



IEIGEN116 QUIT SWITCH SET IN GENERATE MACRO 

Explanation; One or more errors were 
detected during expansion of the GEN- 
ERATE macro-instruction. 

Severity Code; 7 



5,* * * IEICEN104 
SPECIFIED 

5,* * * IEICHA102 
VALUE NOT SPECIFIED 



INSTSET VALUE NOT 



CHANNEL2-ADDRESS 



5,* * * IEICHA102 CHAN# 2- ADDRESS VALUE 
NOT SPECIFIED 



7, * * * GENERATION TERMINATED * * * 

Explanation; The system generation 
process was abnormally terminated. 

Severity Code; 7 



The second example illustrates a mes- 
sage for a CHANNEL macro-instruction. 
"CHANNEL2" is the name field of the 
macro-instruction. The third example 
illustrates the same message, but in 
this case the name field of the macro- 
instruction was omitted and "CHAN#2" 
was supplied by the macro-instruction. 

System Action: The assembler program 
did not produce a job stream in the 
SYSPUNCH data set. The program ana- 
lyzed all remaining system generation 
macro- instructions and printed any 
other required messages. Either mes- 



INFORMATIVE MESSAGES 



*, message text 

Explanation; This type of message 
documents the options selected for the 
new system through the system genera- 
tion macro- instructions. All options 
are described, whether the selection 
was explicit or implicit. 
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Table 7. System Generation Error Messages 

Code 



r T- 

I Message Code| 



h 

lEI 



.+ ^ 

s,* * * lEIaaannn text 

s = Severity code: 

5 Error message; error in coding of a system generation 
macro-instruction. 

7 Error message; message is produced by GENERATE 
macro- ins true tion . 

aaa = Indication of system generation macro-instruction at which 
error was detected: 

aaa Macro-instruction 



ALG 


ALGOL 


AGL 


ALGLIB 


ASM 


ASSEMBLR 


CEN 


CENPROCS 


CHA 


CHANNEL 


CHK 


CHKPOINT 


COB 


COBOL 


COL 


COBLIB 


CTR 


CTRLPROG 


DAT 


DATAMGT 


EDI 


EDITOR 


FOL 


FORTLIB 


FTC 


FORTRAN 


GEN 


GENERATE 


GPH 


GRAPHICS 


IOC 


lOCONTRL 


lOD 


lODEVICE 


LNK 


LINKLIB 


MAL 


MAC LIB 


PLL 


PLILIB 


PLl 


PLl 


PRL 


PROCLIB 


RES 


RESMODS 


RPG 


RPG 


SCH 


SCHEDULR 


SOL 


SORTLIB 


SOR 


SORTMERG 


SUP 


SUPRVSOR 


SVC 


SVCTABLE 


SVL 


SVCLIB 


SYS 


SYSUTILS 


TEL 


TELCMLIB 


TES 


TESTRAN 


UNI 


UNITNAME 



nnn = Message serial number 
text= Message text 



L X J 
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APPENDIX B: CROSS-REFERENCES IN MACRO- INSTRUCTIONS 



This appendix shows in tabular form which macro- instruct ions and 
keywords refer to other macro- instructions or publications. Dependen- 
cies between the keywords of a macro-instruction are not shown because 
they are illustrated by the macro-instruction format and, when neces- 
sary, by tables within each m.acro- instruction description. 

To facilitate reference to other publications, the titles are 
abbreviated as follows: 



Abbreviation 



Publication 



IBM System/3 60 Operating System: 

COBOL F COBOL (F) Programmer's Guide 

Editor Linkage Editor 

FORTRAN E FORTRAN IV (E) Programmer's Guide 

FORTRAN G FORTRAN IV (G) Programmer's Guide 

FORTRAN H FORTRAN IV (H) Programmer's Guide 

JCL Job Control Language 

Operator Operator's Guide 

PL/I PL/I (F) Prograirimer's Guide 

SCB System Control Blocks 

Sort Sort/Merge 

SPG System Programmer's Guide 

Storage Storage Estimates 

Utilities Utilities 

2250 Graphic Programming Services for IBM 2250 Display Unit 



Macro- Instruction 



Keyword 



Refers to 

T 



I Macro-Instruction 



Publication 



lOCONTRL 



UNIT 



lODEVICE 



lODEVICE 



All 



lOCONTRL , UNITNAME 



ADDRESS 



CHANNEL 



DEVTYPE 



-+ 

I SPG, SCB 



OPTCHAN 



CHANNEL 



NUMSECT I 



2250 



UNITNAME 



UNIT 



lODEVICE 



NAME 



SPG 



CTRLPROG 



TYPE 



I CENPROCS 



OVERLAY 


-+- 
1 


CENPROCS 




1 
_1 


LOWTASK 


1 
1 


SCHEDULR, 


SUPRVSOR 


T 
1 


HITASK 


-+- 

i 
-+- 


SUPRVSOR 




1 
_J. 



QSPACE I SUPRVSOR 



I Storage 

-± 



(Continued 
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r T 

Macro- Instruction 



Keyword 



Refers to 



Macro- Instruction 
CTRLPROG 



Publication 



SCHEDULR 



TYPE 



CONSOLE 



ALTCONS 



lODEVICE 
lODEVICE 



OPTIONS 



JCL 



STARTR 



STARTW 



lODEVICE 
lODEVICE 



ACCTRTN 



SPG 



WTOBFRS 



REPLY 



CTRLPROG 
CTRLPROG 



PROCRES 



JOBQRES 



lODEVICE 
lODEVICE 



JOBQFMT 



SPG 



JOBQLMT 



SGP 



JOBQTMT 



SPG 



INITQBUF 



MINPART 



SUPRVSOR 
SUPRVSOR 



4. 



Storage 



Storage 



SUPRVSOR 
(For further details 
refer to Table 6) 



RESIDENT 



OPTIONS 



CTRLPROG 
CTRLPTOG. SUPRVSOR 



SPG 



Operator 



WAIT 



TIMER 



CTRLPROG 
CTRLPROG 



TRACE 



SPG 



4 



SER 



CENPROCS 
RESMODS,SVCLIB 



-f 



Storage 



SVCTABLE 



All 



SPG 



RESMODS 



MEMBERS 



SVCTABLE 
SVCTABLE 



SPG 



SVCLIB 



All 



MEMBERS 



SPG 



PROCLIB 



All 



UNITNAME 



DATAMGT 



ACSMETH 



CTRLPROG 
SUPRVSOR 
TELCMLIB 



(Continued) 
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T T 

Keyword 



Macro- Instruction 



Refers to 
^ 



Ma cro- Instruction 



Publication 



EDITOR 



All 



+- 



Utilities, Storage 



ASSEMBLR 



All 



Utilities, Storage 



SORTMERG 



All 



SIZE 



EDITOR, SORTLIB 
CENPROCS 



Sort 



MESSAGE 



Sort 



SORTLIB 



All 



SORTMERG 
CTRLPROG 



CHKPOINT 



All 



ALGOL 



All 



CENPROCS, ALGLIB 
CENPROCS, COBLIB 



COBOL 



All 



Utilities, Storage 



SIZE 



COBOL F 



FORTRAN 



All 



DESIGN 



STORAGE 



CENPROCS 
CENPROCS 
CTRLPROG 



SIZE (E) 



SIZE (H) 



Utilities, Storage 



FORTRAN E 



4- 



FORTRAN H 



-+- 



FORTLIB 



All 



GRAPHICS 



OBJERR 



ONLNRD 



ONLNPCH 



FORTRAN E 



-+- 



FORTRAN E 
FORTRAN G 
FORTRAN H 



FORTRAN G 
FORTRAN H 



FORTRAN G 
FORTRAN H 



PLl 



All 



CENPROCS 
SUPRVSOR 
PLILIB 



SIZE 



PL/I 



GENERATE 



GENTYPE 



LEPRT 
JL - X 



Operator 



Editor 
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APPENDIX C: GENERIC UNIT NAMES 



Unit names are automatically assigned during system generation to 
collections of devices for each type of device specified by the UNIT 
parameter of an lODEVICE macro-instruction. The names and the devices 
to which they apply follow. 

Magnetic Tape Drives 

Unit Name Device Type 

2400 2400 9-track Magnetic Tape Drive 

having only an 800 byte-per-inch (density) capability 
2400-1 2400 Magnetic Tape Drive with 7-track 

Compatibility and without Data conversion 
2400-2 2400 Magnetic Tape Drive with 7-track 

Compatibility and Data conversion 
2400-3 2400 or 2415 9-track Magnetic Tape Drive 

having only a 1600 byte-per-inch (density) capability 
2400-4 2400 or 2415 9-track Magnetic Tape Drive having 

an 800 and 1600 byte-per-inch (density) capability 

Direct-Access Devices 



Unit Name 

2301 

2302 

2303 

2311 

2314 

2321 



Device Type 

2301 Drum Storage 

Any 2302 Disk Storage Drive 

Any 2303 Drum Storage Drive 

2311 Disk Storage Drive 

2314 Direct-Access Storage Facility 

2321 Data Cell 



Unit Record Equipment 



Unit Name 
T052 

1403 

1442 
1443 

2501 
2520 



Device Type 

1052 Printer-Keyboard 

1403 Printer or 1404 Printer (continuous form only) 

1442 Card Read Punch 
Any 1443 Printer 

Any 2501 Card Reader 
2520 Card Read Punch 



2540 
2540-2 

2671 

Graphics Devices 

Unit Name 
T053 
2250-1 
2250-3 

2260-1 
2260-2 

2280 
2282 



2540 Card Read Punch iread feed) 
2540 Card Read Punch (punch feed) 

2671 Paper Tape Reader 



Device Type 
1053 Model 4 Printer 
2250 Model 1 Display Unit 
2250 Model 3 Display Unit 

2260 Model 1 Display Station (local attachment) 
2260 Model 2 Display Station (local attachment) 

2280 Film Recorder 

2282 Film Recorder/Scanner 
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APPENDIX D: SUPPORTING ADDITIONAL I/O DEVICES 



The limits specified in the lOCONTROL, lODEVICE, and UNITNAME 
macro- instructions may be increased by following a special procedure. 
The procedure consists of two steps, namely: 

• Redefining SGGBLPAK, a member of the data set SYS1.GENLIB, during 
the preparation for system generation. 

• Inserting additional statements in the input deck to system 
generation. 

The new limits will allow 248 I/O devices, 80 control units and 100 
unit names. If these limits are set, system generation can only be 
performed on a central processing unit that has at least 128K bytes of 
main storage. 

Redefining SGGBLPAK 

SGGBLPAK can be redefined by executing the lEHPROGM utility program 
which is used during the preparation for system generation. The two 
utility control statements required are: 

RENAME DSNAME=SYS 1 .GENLIB,VOL=23 1 1=DLIB02 ,jyiEMBER=SGGBLPAK, X 

NEWNAME=SGPAK 9 6 

RENAME DSNAME=SYS 1 . GENLIB, VOL=23 1 1=DLIB02 ,MEMBER=SGPAK248 , X 

NEWNAME=SGGBLPAK 

These statements can be included in the input deck for initializing 
the system data sets during the preparation for system generation, or in 
a separate execution of the program. The following DD statement must 
also be present in the step. 

//DDCD DD DSNAME=SYS1. GENLIB, DISP=OLD 

To reestablish the standard definitions after system generation, the 
following statements should be used with lEHPROGM: 

RENAME DSNAME=SYS 1 . GENLIB, VOL=23 1 1=DLIB02 ,MEMBER=SGGBLPAK , X 

NEWNAME=SGPAK2 4 8 

RENAME DSNAME=SYS 1 . GENLIB, VOL=23 1 1=DLIB02 ,MEMBER=SGPAK96 , X 

NEWNAME=SGGBLPAK 

In all the previous statements, it is assumed that SYS 1. GENLIB 
resides on a 2311 direct-access volume whose serial number is DLIB02. 
If SYS1. GENLIB resides on a different volume or device, the volume 
serial number and device type should be modified accordingly. All other 
parameters must be coded as shown. 

Inserting Additional Statements 

The following two statements must be inserted in the input deck to 
the system generation process. They must immediately follow the DD ♦ 
statement and precede any system generation macro-instructions. The 
statements are: 

COPY SGGBLPAK 
6LIMIT (1) SETB 1 
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APPENDIX E: STARTER OPERATING SYSTEM 



IBM provides a starter operating system that can be used for the 
first system generation. The starter operating system must be initial- 
ized and made operational before it can be used as a generating system. 
The starter operating system and the procedures required to initialize 
it are described in this appendix. 



THE STARTER OPERATING SYSTEM PACKAGE 

The starter operating system package consists of an operating system 
and a set of libraries. The operating system includes: 

• Control program 

• Data set utilities 

• System utilities 

• Assembler F 

• Linkage Editor E 

In addition to the operating system, the starter operating system 
package includes the libraries listed below. The last four libraries 
listed (COBOL, FORTRAN, PL/I, and Sort libraries) are optional for 
customized distribution. Each library is a partitioned data set (PDS) . 

• SYSl.SAMPLIB (sample library): This library provides 80-character 
card images. It contains sample programs to test the functioning of 
components of the generated operating system, the IPL program 
(lEAIPLOO) , a dump program (PROCDUMP) and a non- executable example 
of writing an accounting routine (SAMACTRT) . It also contains the 
following independent utility programs: 

1. IBCDASDI (initialization of direct-access volumes) 

2. IBCDMPRS (dump/restore) 

3. IBCRCVRP (recover/replace) 

• SYSl.MODLIB (module library) 

• SYSl.GENLIB (generation library) — This library has a blocking 
factor of U2. 

• SYSl.PROCLIB (procedure library) 

• SYSl.MACLIB (macro library) — This library has a blocking factor of 
42. 

• SYSl.COBLIB (COBOL library) 

• SYSl.FORTLIB (FORTRAN library) — This library is distributed 
without members. 

• SYSl.PLILIB (PL/I library) 

• SYS1.S0RTLI3 (sort library) 
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DISTRIBUTION METHODS 

The Starter operating system package is provided by one of the 
following distribution methods: 

• Complete starter operating system package for the 2311 Disk Storage 
Drive; This package is distributed on three disk packs or on three 
tapes for restoring disk packs. The volume serial numbers of the 
disk packs are DLIBOl, DLIB02, and DLIB03. 

• Customized starter operating system package for the 2311 Disk 
Storage Dyive ; This package is distributed on two disk packs or on 
two tapes for restoring disk packs. The volume serial numbers of 
the disk packs are DLIBOl and DLIB02. 

• Complete starter operating system package for the 2314 Disk Storage 
Facility; This package is distributed on one tape for restoring a 
disk pack. The volume serial number of the disk pack is DLIBOl. 

The starter operating system package distributed on disk packs is 
operable (though a backup copy of it should be made) . It contains the 
starter operating system and the libraries as they are shown in Figure 
47. (The data sets are not necessarily provided in the order shown.) 

The starter operating system package distributed on tape includes all 
of the contents of the disk packs. However, since the tapes must be 
restored onto disk packs, two additional independent utility programs — 
IBCDASDI and IBCDMPRS — are provided at the beginning of each tape for 
use in restoring the disk packs. In Figure 47, the tape layout is shown 
beside the corresponding disk pack. Only the libraries shown on the 
disk packs are restored from the tapes. The IBCDASDI and IBCDMPRS 
programs will always be at the beginning of the tapes, but the other 
data sets may not be in the order shown. The 2314 distribution is 
available only on tape, and must be restored onto the disk pack from the 
tape. 
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COMPLETE 2311 PACKAGE 




-jj gl.COBU B^ 
~SV g1. FORTU g^ 
-SYSt^PUUB^ 
-SYS1. PROCUg, 



DISK DISTRIBUTION 



DL/B01 



DASDI 



DUMP/RESTORE 



T/M 



STARTER 

OPERATING 

SYSTEM 



SrS1. SORTLIB 



SYS 1. COBLIB 



SYS 1. FORTLIB 



SYS1. PL1L1B 



SYS 1. PROCLIB 



T/M 



TRAILER RECORD 

FOR DUMP/RESTORE 

T/M 



DLIB02 



DASDI 



DUMP/RESTORE 



T/M 



SYS 1. MACLIB 



SYS1. GENLIB 



SYS 1. SAMPLIB 



T/M 



TRAILER RECORD 

FOR DUMP/RESTORE 

T/M 



DLIB03 



DASDI 



PUMP/RESTORE 



T/M 



SYS 1. MODLIB 



T/M 



TRAILER RECORD 
FOR DUMP/RESTORE 
T/M 



TAPE DISTRIBUTION 



CUSTOMIZED 2311 PACKAGE 




OPTIONAL 
LIBRARIES" 



DISK DISTRIBUTION 



DLIB01 



DASDI 



DUMP/ RESTORE 



T/M 



STARTER 

OPERATINS 

SYSTEM 



SYS1. MODLIB 



SYS 1. SORTLIB 



SYS1. COBLIB 



SYS1. FORTLIB 



SYS1. PL1LIB 



SYS1. PROCLIB 



T/M 



TRAILER RECORD 
FOR PUMP/RESTORE 



TihA 



DLIB02 



DASDI 



DUMP/RESTORE 



T/M 



SYS1. MACLIB 



SYS 1. GENLIB 



SYS 1. SAMPLIB 



T/M 



TRAILER RECORD 
FOR DUMP/RESTORE 



T/M 



TAPE DISTRIBUTION 



COMPLETE 2314 PACKAGE 



DLIB01 



DASDI 



DUMP/RESTORE 



T/M 



STARTER 

OPERATING 

SYSTEM 



SYSl MODLIB 



SYS 1. SORTLIB 



SYSl. COBLIB 



SYS1. FORTLIB 



SYSL PL1LIB 



SYS1. PROCLIB 



SYSl. MACLIB 



SYSl GENLIB 



SYSl SAMPLIB 



T/M 



TRAILER RECORD 
FOR DUMP/RESTORE 



T/M 



STARTER 
OPERATING 

^SYSTEM _ 
-JV SI. MODLj g- 
<§Y S1. SORTLJ g- 
-jY S 1. COBLIB ^ 
-SY S 1 FORTLI B- 
■jY Sl PLILIB ^ 
-§V S1 PROCLj g- 
-jY Si. MACLI B^ 
-§Y Sl GEMLIg ^ 
~5YS1. SAMPUg^ 



DISK PACK CONTENTS 
AFTER RESTORING FROM TAPE 



TAPE DISTRIBUTION 



Figure 47. Arrangement of Data Sets 
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STARTER SYSTEM REQUIREMENTS 

The Starter operating system requires 64K bytes of main storage for 
operation. It contains a control program that can support the machine 
configuration shown in Figure U8 or any subset meeting the minimum 
requirements listed in Table 8. 

The control program permits the use of the generic unit names listed 
in Table 9; additional unit names provided in the starter operating 
system are listed in Table 10. 

The starter operating system requires that all devices to be used by 
the system be ready prior to IPL. Any device not ready will automatic- 
ally be varied off line at IPL time. If any device which was not ready 
at IPL is required during a job step, the operator should enter a VARY 
ONLINE command for that device. When using the starter operating 
system, it is permissible to have devices other than those shown in 
Figure 4 8 attached to the system. However, an interruption must not be 
issued from any of these additional devices while the starter operating 
system is running. For example, the operator must not make ready any 
one of these devices. 

If system generation is performed with the starter operating system 
using a 1403 printer with the universal character set feature, the BPS 
UCS utility program (360P-UT-0U8) must be executed prior to this in 
order to load the generator storage. When the UCS program is executed, 
NO-FOLDING and BLOCK- DATA- CHECK must be specified. This program is 
described in the publication IBM System/360 Basic Programming Support: 
Universal Character Set Utility Program Operating Guide , Form C2U-3396. 
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1052 Printer 
Keyboard 

"009 



1052 Printei 
Keyboard 

"oTf 



1442 

Read Punch 
I OOA 



1443 

Printer 



OOB 



2540 
Reader 



2540 
Punch 



1403 
Printer 



2821 
Control 



Mpx 
Channel 



System/360 
Model 30, 40, 50, 65 or 75 



Selector 
Channel 1 



2314 
130-133 



2820 
Control 



2301 
Drum 



2841 
Storage 
Control 



2311 
"l90" 



2311 



2311 
192 



2311 
193 



Tape 
Control 





*These tapes must be 7 track tape units with the data conversion feature. 
All others must be 9 track tape units. 

**A 2303 may be substituted for any one of the 231 1's attached to the 
2841 Storage Controls on Selector Channel 1 and Channel 2. The 
2303 addresses will be 197 and 297. 

Figure 48. System Configuration 



230-233 



2311 
290 



2311 
291 



2311 
292 



2311 
293 



2841 
Storage 
Control 



Tape 
Control 



Selector 
Channel 3 



Selector 
Channel 2 



2820 
Control 



2301 
Drum 



2150/1052 
Cons ole 
I 309 



2150/1052 
Console 



2150/1052 
Console 



Read Punch 
I 20A 



1443 
Printer 



2821 
Control 



2540 
Reader 



2540 
Punch 



1403 
Printer 
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^ TABLES. MINIMUM I/O REQUIREMENTS 



Minimum 
Requirement 


Function 


Choose from the following 


Device 


Device Address 


MPX Channel 


Selector 
Channel 1 


Selector 
Channel 2 


Selector 
Channel 3 


1 


System Console 


1052 


009,01 F 




209,21 F 


309 


2150/1052 


009,01 F 




209,21 F 


309 


2 


Storage Units for System 
Residence and Data Sets 


2311 




190,191,192,193 


290,291,292,293 




1 


System Input 


2540 Reader 


OOC 




20C 




1442 Read Punch* 


OOA 




20A 




2400 (7 Tr-DC) 




180,181 


280,281 




2400 (9- Track) 




182,183,184 


282,283,284 




1 


Punch Output 


2540 Punch 


OOD 




20D 




1442 Read Punch* 


OOA 




20A 




2400 (7- Tr-DC) 




180,181 


280,281 




2400 (9- Track) 




182,183,184 


282,283,284 




1 


Print Output 


1443 


OOB 




20B 




1403 


OOE 




20E 




2400 (7-Tr-DC) 




180,181 


280,281 




2400 (9- Track) 




182,183,184 


282,283,284 




2 ** 


intermediate (Work) Data Sets 


2311 




190,191,192,193 


290,291,292,293 




2301 


ICO 


2C0 


2400 (9-Track) 


182,183,184 


282,283,284 


2** 


intermediate (Work) Data Sets 


2311 




190,191,192,193 


290,291,292,293 




2301 


ICO 


2C0 


2303 


197 


297 


1 ** 


intermediate (Work) Data Sets 


2314 




130-133 


230-233 




* A single 1442 may serve as either system input or punch output, but not both simultaneously. 
** The same direct access storage devices may serve for system residence and sequential and partitioned data sets if sufficient space is available. 



Table 



Generic Unit Names 



Magnetic Tape Drives 



Unit Name 

2400 

2400-2 



Direct-Access Devices 



Unit Name 

2311 

2301 

2303 

2314 



Unit Record Equipment 



Unit Name 

1052 

1403 

1442 

1443 

2540 

2540-2 



Device Type 

2400 Series 9-track Magnetic Tape Drive 

2400 Series Magnetic Tape Drive with Seven Track 

Compatibility and Data Conversion 



Device Type 

2311 Disk Storage Drive 

2301 Drum Storage 

2303 Drum Storage 

2314 Disk Storage Facility 



Device Type 

1052 Printer Keyboard 

1403 Printer 1404 Printer (continuous form only) 

1442 Serial Reader Punch 

1443 Printer 

2540 Reader Punch (read feed) 
2540 Reader Punch (punch feed) 



Table 10. Additional Unit Names Supporting IBM Supplied Cataloged 
Procedures 

r T T 

I Name | Function I 

^ 4 -I 

SYSSQ I Sequential access on devices at any of the following addresses: 
|182, 183, 184, 282, 283, 284, 190, 191, 192, 193, 290, 291, 292, | 
[293 (any 9-track tape or 2311 disk storage drive). 



-I 

SYSDA I Direct access on devices at any of the following addresses: 
|190, 191, 192, 193, 290, 292, 293, (any 2311); iCO , 2C0 (any| 
12301; 197, 297 (any 2303): 130, 131, 132, 133, 230, 231, 232,] 
I 233 (any 2314). | 

+ ^ 



SYSCP|A 2540 card punch at address OOD or 20D, or 1442 at address 00A| 
jor 20A. I 

L X J 
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PROCESSING THE STARTER PACKAGE 

Before the starter operating system package can be used for system 
generation, it must be initialized and prepared for use. If the package 
is on tape , preparation consists of: 

1. Restoring the system to disk (the tape then becomes a backup copy 
of the system) . 

2. Punching the independent utility programs and the sample programs 
from SYSl.SAMPLIB for later use. 

3. Listing the data describing the system. 

If the starter operating system package is on disk , preparation 
consists of: 

1. Punching the independent utility programs and the sample programs 
from SYSl.SAMPLIB for later use. 

2. Creating a backup copy of the system on disk or tape. 

3. Listing the data describing the system. 

Processing of the tape or disk distribution of the starter operating 
system package is depicted in Figure 49. Detailed processing instruc- 
tions are contained in the procedure section that follows. 



f Tape > 
V^Distributiony 


) 


r Disk > 

\Distribution^ 


) 




1 
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Disk Pack(s) 
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1 
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Disk 






, 




(^lEAIPLOO 
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(^RECOVREP 
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/ 
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. 
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Disk(s) 
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List System 
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Scratch 
Libraries 





Figure 49, 
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PROCEDURES FOR PROCESSING THE STARTER PACKAGE 

This section contains detailed procedures for processing the various 
types of starter operating system packages. Procedures are given for: 

• Complete or customized 2311 package — tape distribution. 

• Complete or customized 2311 package — disk pack distribution with 
tape backup. 

• Complete or customized 2311 package — disk pack distribution with 
disk pack backup. 

• Complete 2314 package — tape distribution. 



In addition, a procedure 
starter operating system. 



is given for deleting libraries from the 



The procedures include examples of control decks, 
the underlined fields are those that may require 
different installations. Further explanation of the 
is contained in the publication IBM System/360 
Utilities , Form C28-6586. Users should remember to 
decks for the distribution they receive: a complete 
volume serial numbers DLIBOl, DLIB02, and DLIB03 
package uses volume serial numbers DLIBOl and DLIB02; 
uses only volume serial number DLIBOl. 



In these examples, 

modification for 

field requirements 

Operating System: 



tailor the control 
2311 package uses 
; a customized 2311 

and a 2314 package 



For illustrative purposes , the given procedures 
devices and device addresses listed in Table 11. 



assume the set of 



Table 11. Sample Configuration 



■T T 

j Input/Output Device \ Address 



j Device Function 
|. 



Printer Keyboard | 


1052 






OIF 


System Residence and| 










System Data Sets | 










DLIBOl 1 


2311 


(or 2314) 




190 (or 130) 


DLIB02 1 


2311 






191 


DLIB03 1 


2311 






192 


System Input j 


2540 


Reader 




OOC 


Punch Output 1 


2540 


Punch 




OOD 


Print Output | 


1403 


Printer 




OOE 


Tape Drives^ | 


2400 


Tape 




1802 




2400 


Tape 




1812 




2400 


Tape 




1822 


_ _J._ 






1 





^Tape units are required only if the starter package is received on 

tape or if system backup is created on tape. 
2Tape units located at addresses 18 and 181 are 7-track tape units 

with the data conversion feature. The tape unit at 182 is a 9-track 

tape unit. 
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2311 Package — Tape Distribution 

The procedure for processing the tape distribution of the 2311 
starter operating system package is as follows: 



Initialize Disk 



1. 
2. 
3. 



Mount the disk pack onto which DLIBOl is to be restored. 



Mount tape #1 (DLIBOl) of starter package. 



Load IBCDASDI program from tape by setting the load selector 
switches and pressing the console LOAD key. When the program is 
loaded, the wait state is entered and the hexadecimal value FFFF 
is displayed in the console lights. 

■H 



Place the following control deck in the input device to initial- 
ize the disk. 
JOB 

MSG TODEV=1403 , TOADDR =00E 

DADEF TODEV=2311,TOADDR=190,VOLID=SCRATCH, X 

FLAGTEST=NO 

NEWVOLID= 111111 , OWNERID=DEPT38 
STRTADR=50 , EXTENT=10 



VLD 

VTOCD 

END 



In the DADEF statement, the FLAGTEST=NO parameter must only be 
used when the disk is initialized for the first time. 



Define the control statement input device by pressing the REQUEST 
key of the printer keyboard. The message DEFINE INPUT DEVICE 
will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
the device type, c is the channel address, an uu is the unit 
address. The device type can be 1UU2, 2400, or 2540. 



When the disk initialization is complete, the message END OF JOB 
is printed on the message output device, and the program enters 
the wait state. 



Restore Tape to DISK 



Load the IBCDMPRS program from tape by setting the load selector 
switches and pressing the console LOAD key. When the program is 
loaded, the wait state is entered and the hexadecimal value FFFF 
is displayed in the console lights. 



restore the 



Place the following deck in the input device to 
contents of the tape to the disk. 

JOB 

MSG TODEV=1403,TOADDR=00E 

RESTORE FROMDEV=2 400, FROMADDR=180 , T0DEV=2 311 , 
TOADDR= 19 , V0LID= 111111 

END 



when restoring is complete, the serial number of the disk has 
been changed from 111111 to DLIBOl. 



(Continued) 
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■T • 1 

, I Define the control statement input device by pressing the REQUEST 
I key of the printer keyboard. The message DEFINE INPUT DEVICE 
I will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
I the device type, c is the channel address, and uu is the unit 
jaddress. The device type can be 1U42, 2400, or 2540. 



10. I When the restoring is complete, the message END OF JOB is printed 
I on the message output device, and the program enters the wait 
(state. The DLIBOl tape should be removed and stored in the tape 
I library for backup purposes. 

J. 



Initialize and Restore Second Disk 
^ ^ 

11. I Repeat steps 1 through 10 to initialize and restore the second 
jdisk from tape #2 (DLIB02) . 

J. 



Initialize and Restore Third Disk 



T 

12. I Repeat steps 1 through 10 to initialize and restore the third 
jdisk from tape #3 (DLIB03) . Users of the customized starter 
(package should skip this step. 

± 1 



Punch Utility and Sample Programs 



13. j Completion of the preceding steps provides operable disk packs 
(with backup tapes. Proceed to punch the independent utility 
I programs and any sample programs desired. Be sure all necessary 
I volumes are mounted and make ready all devices to be used. 

. + _ ^ 



14. I The following control deck should be placed in the input device. 

j/ZJOBl JOB ACCT123 , PROGRAMMER , iyiS6LEVEL=l 

|// EXEC PGM=IEBPTPCH 

j/ZSYSUTl DD DSNAME=SYSl.SAiyiPLIB, X 

|// DISP= (OLD, KEEP) ,UNIT=2 311, X 

j// VOLUME=SER=DLIB02 

I //SYSUT2 DD UNIT= 2540-2 
j/ZSYSPRINT DD SYSOUT=A 

I //SYS IN DD * 

I PUNCH TYP0RG=P0,MAXNAME=4 

I MEMBER NAME=IBCDMPRS 

I MEMBER NAME=IBCDASDI 

I MEMBER NAME=IEAIPL00 

I MEMBER NAME=IBCRCVRP 

I 

I A MEMBER card should be added to the above control deck for each 
I sample program desired for later use, and for SAMACTRT and 
JPROCDUMP, provided the MAXNAME field in the PUNCH control card is 
(adjusted to show the revised number of member cards in the deck. 
(The member name card (first card) should be removed from each 
(member deck punched. (Refer to the "Testing the New System" 
(section of this publication for names of the sample programs.) 

X J 

(Continued) 
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r T ■ 

15. I Set the LOAD UNIT switches on the control panel to the channel, 
I control unit, and device of the system residence volume (DLIBOl) . 
I Then press the LOAD key. 



H 



16. jwait for the READY message and for the WAIT light to be turned 

I on. Then enter a SET command specifying the date, as follows: 

I 

I a. Press REQUEST key. 

|b. Wait for READ light to go on. 

|c. Type SET DATE=yy.ddd to specify date. 

1 d. Hold alternate coding key and press the numeric 5 key (EOB) . 



17. i The starter operating system has built-in START RDR and START WTR 
I commands, which are issued automatically. These commands are: 

I 

I START RDR,OOC 
I START WTR,OOE 

I 

I If these are not the addresses of the reader and writer to be 

I used, override these commands by entering new ones for the proper 
I devices. 

■H 



18. (Enter a START command with no parameters. When the job is 
1 complete, a READER CLOSED message will be printed, followed by a 
I READY message. Then the system will enter the wait state. 

X 



List System Data 



19. I To list the data describing the system, place the proper control 
deck shown below in the input device. Then enter a START RDR 
command followed by a START command. 

Control deck for users of the complete 2311 package: 
//J0B2 JOB ACCT123 , PROGRAMMER , MS GLEVEL=1 
//STEPl EXEC PGM=IEHLIST 

SYSOUT=A 

UNIT=2311,DISP=OLD, X 

VOLUME=SER=DLIB01 

UNIT=( 191,, DEFER) , DISP= (NEW, KEEP) , X 

VOLUME= ( PRIVATE , RETAIN) 

UNIT=( 192,, DEFER) ,DISP= (NEW, KEEP) , X 

VOLUME=^ (PRIVATE , RETAIN) 

* 

LISTCTLG 

LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2311=DLIB02 

LISTVTOC DUMP,VOL=2311=DLIB03 

LISTPDS DSNAME= ( SYSl . PROCLIB , SYSl . COBLIB 

[, Optional PDSs on System Residence]) 
LISTPDS VOL=2311=DLIB02, X 

DSNAME= (SYS l.GENLIB, SYSl. SAMPLIB 
[, Optional PDSs on DLIB02]) 
LISTPDS VOL=2311=DLIB03, X 

DSNAME =SYS1.M0DLIB 
/* 

(Continued) 



//SYSPRINT 


DD 


//DDl 


DD 


// 




//DD2 


DD 


// 




//DD3 


DD 


// 




//SYSIN 


DD 
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Control deck for users of the customized 2311 package: 



//JOB 2 
//STEPl 
//SYSPRINT DD 



//DDl 
// 

//DD2 
// 
//SYS IN 



/* 



JOB ACCT123 , PROGRAMMER , MSGLEVEL=1 
EXEC PGM=IEHLIST 

SYSOUT=A 
DD UNIT=2311,DISP=OLD 

VOLUME=SER=DLIB 01 
DD UNIT= ( 191 , , DEFER) , DISP= (NEW, DEEP) , 

VOLUME= ( PRIVATE , RETAIN ) 
DD * 
LISTCTLG 
LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2311=DLIB02 
LISTPDS DSNAME= (SYSl . PROCLIB , SYSIMODLIB 

[, Optional PDSs on System Residence]) 
LISTPDS VOL=2311=DLIB02, 

DSNAME= (SYS 1 . GENLIB , SYS 1 . SAMPLIB 
[, Optional PDSs on DLIB02]) 



No MOUNT statement should be entered between IPL time and JOB2 
for the drive on which DLIB02 is mounted. If J0B2 is run 
immediately after JOBl (in step 14) , eliminate the J0B2 card. 

The physical address underlined in the DD2 statement should be 
the address of the device containing DLIB02. The physical 
address underlined in the DD3 statement should be the address of 
the device containing DLIB03. 



In the LIST deck, any of the partitioned data sets 
Figure 47 may be specified in the LISTPDS statement. 



shown in 
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2311 Package — Disk Pack Distribution (Tape Backup) 

The procedure for processing the disk pack distribution of the 2311 
starter operating system package, with tape backup, is as follows: 



Punch Utility and Sample Programs 



The disk packs are operable as received. Proceed to punch the 
independent utility programs (needed to create a tape backup copy 
of the disks) and any sample programs desired. Be sure all 
necessary volumes are mounted and make ready all devices to be 
used. 

-H 



The following control deck should be placed in the input device. 



//JOBl 




JOB 


// 


EXEC 


//SYSUTl 




DD 


// 
// 






//SYSUT2 




DD 


//SYS PRINT 


DD 


//SYSIN 




DD 



ACCT123 , PROGRAMMER , MS GLEVEL=1 

PGM=IEBPTPCH 

DSNAME=SYS1 . SAMPLIB , 

DISP= (OLD, KEEP) ,UNIT=2311, 

VOLUME=SER=DLIB 2 

UNIT= 2540-2 

SYSOUT=A 

* 

PUNCH TYP0RG=P0,MAXNAME=4 
MEMBER NAMii;=IBCDMPRS 
MEMBER NAME=IBCDASDI 
MEMBER NAME=IEAIPLOO 
IffiMBER NAME=IBCRCVRP 



/* 



-+- 



A MEMBER card should be added to the above control deck for each 
sample program desired for later use, and for SAMACTRT and 
PROCDUMP, provided the T^iAXNAME field in the PUNCH control card is 
adjusted to show the revised number of member cards in the deck. 
The member name card (first card) should be removed from each 
member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 



3. 



Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system residence volume (dLIBOD . 
Then Dress the LOAD kev. 



4. 



-+- 



Wait for the READY message and for the WAIT light to be turned 
on. Then ente^r a SET command specifying the date, as follows: 

a. Press REQUEST key. 

b. Wait for READ light to go on. 

c. Type SET DATE=yy.ddd to specify date, 
d- Hold alternate coding key and press the numieric 5 key (EOB) . 



The starter operating system has built-in START RDR and START WTR 
commands, which are issued automatically. These commands are: 

START RDR, OOC 
START WTR, OOE 

If these are not the addresses of the reader and writer to be 
used, override these comiDands by entering new ones for the proper 
devices. 



(Continued) 
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r T 1 

6. I Enter a START command with no parameters. When the job is 

I complete, a READER CLOSED message will be printed, followed by a 
I READY message. Then the system will enter the wait state. 
|. J. 



Dump Disk to Tape 



7. 



+- 



Place the IBCDMPRS program (punched from SYSl.SAMPLIB in Step 2) 
in the input device , followed by the control deck shown below. 



JOB 
MSG 
DUMP 

END 



TODEV=1403 , TOADDR=00E 
FROMDEV= 2311, FROMADDR= 190 , 
TODEV= 2400, TOADDR= 181 



Mount the tape that is to contain the backup copy 
disk pack (DLIBOl) . 



of the first 



-+- 



9. 



Load the IBCDMPRS program by setting the load selector switches 
and pressing the console LOAD key. When the program is loaded, 
the wait state is entered and the hexadecimal value FFFF is 
displayed in the console lights. 



10. 



Define the control statement input device by pressing the REQUEST 
key of the printer keyboard- The message DEFINE INPUT DEVICE 
will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
the device type, c is the channel address, and uu is the unit 
address. The device type can be 1442, 2400, or 2540. 



11, 



H- 



When dumping onto the tape is complete, the message END OF JOB is 
printed on the message output device, and the program enters the 
wait state. The tape should be removed and stored in the tape 
library. 



Dump Second Disk to Tape 



^ -j 

12. [Repeat steps 7 through 11 to dump the contents of the second disk 
[pack (DLIB02) onto a second tape. 

± ^ 



Dump Third Disk to Tape 



13. [Repeat steps 7 through 11 to dump the contents of the third disk 
J pack (DLIB03) onto a third tape. Users of the customized starter 
I package should skip this step. 

± J 

(Continued) 
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lU. 



To list the data describing the system, load the operating 
system, and place the proper control deck shown below in the 
input device. Then enter a START command with no parameters. 

Control deck for users of the complete 2311 package: 

//J0B2 JOB ACCT123 , PROGRAMMER , MS GLEVEL=1 

//STEPl EXEC PGM=IEHLIST 

//SYSPRINT DD SYSOUT=A 

//DDl DD UNIT=2311,DISP=OLD, X 

// VOLUME=SER=DLIB01 

//DD2 DD UNIT= ( 191 , , DEFER) , DISP= (NEW, KEEP) , X 

// VOLUME= ( PRIVATE , RETAIN ) 

//DD3 DD UNIT= (192,, DEFER), DISP=( NEW, KEEP), X 

// VOLUME= ( PRIVATE , RETAIN) 

//SYSIN DD * 

LISTCTLG 

LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2 311=DLIB02 

LISTVTOC DUMP,VOL=2311=DLIB03 

LISTPDS DSNAME= ( SYSl . PROCLIB , S YSl . COBLIB 

[, Optional PDSs on System Residence]) 

LISTPDS VOL=2311=DLIB02, X 

DSNAME = (SYSl. GENLIB, SYSl. SAMPLIB 
[, Optional PDSs on DLIB02]) 

LISTPDS VOL=2311=DLIB03, X 

DSNAME =SYS1.M0DLIB 
/* 

Control deck for users of the customized 2311 package: 
//J0B2 JOB ACCT123 , PRQGRM1MER , MSGLEVEL=1 
//STEPl EXEC PGM=IEHLIST 
SYSOUT=A 

UNIT=2311,DISP=OLD, X 

VOLUME=SER=DLIB01 

UNIT= ( 191 , , DEFER) , DISP= (NEW, KEEP) , X 

VOLUME= ( PRIVATE , RETAIN) 
* 

LISTCTLG 
LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2311=DLIB02 
LISTPDS DSNAME=( SYSl. PROCLIB, S YSl MODLIB 

t, Optional PDSs on System Residence]) 
LISTPDS VOL=2311=DLIB02, X 

DSNAME = (SYSl . GENLIB , SYSl . SAMPLIB 
[, Optional PDSs on DLIB02]) 
/* 

The physical address underlined in the DD2 statement should be 
the address of the device containing DLIB02. The physical 
address underlined in the DD3 statement should be the address of 
the device containing DLIB03. 

In the LIST deck, any of the partitioned data sets shown in 
Figure 47 may be specified in the LISTPDS statement. 



//SYSPRINT DD 



//DDl 
// 

//DD2 
// 

//SYSIN 



DD 



DD 



DD 
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2311 Package — Disk Pack Distribution (Disk Backup) 



The procedure for processing the disk pack distribution of the 
starter operating system package, with disk backup, is as follows: 



2311 



Punch Utility and Sample Programs 



1. 



4- 



The disk packs are operable as received. Proceed to punch the 
independent utility programs (needed to create a disk backup copy 
of the disks) and any sample programs desired. Be sure all 
necessary volumes are mounted and make ready all devices to be 
used. 



2. 



The following control deck should be placed in the input device. 



//JOBl 

// 

//SYSUTl 

// 

// 

//SYSUT2 

//SYSPRINT 

//SYSIN 



JOB ACCT123 , PROGRAMMER , MSGLEVEL=1 
EXEC PGM=IEBPTPCH 

DD DSNAME=SYS1 . SAMPLIB , 

DISP=( OLD, KEEP) ,UNIT=2311, 

VOLUME= SER=DLIB 2 

UNIT=254G-2 



DD 
DD 
DD 



SYSOUT=A 
* 

PUNCH TYP0RG=P0,MAXNA]y!E=4 
MEMBER NAME-DUMPREST 
MEMBER NAME=DASDI 
MEMBER NAME";=IEAIPLOO 
ME.MBER NAME=REC0VREP 



/* 



A MEMBER card should be added to the above control deck for each 
sample program desired for later use, provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number 
of member cards in the deck. The member name card (first card) 
should be removed from each member deck punched. (Refer to the 
"Testing the New System" section of this publication for names of 
the sample programs.) 



3. 



Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system residence volume (DLIBOl) . 
Then press the LOAD key. 



U. 



Wait for the READY message and for the WAIT light to be turned 
on. Then enter a SET command specifying the date, as follows: 

a. Press REQUEST key. 

b. Wait for READ light to go on. 

c. Type SET DATE=yy,ddd to specify date. 

d. Hold alternate coding key and press tne numeric 5 key (EOB) . 



5. I The starter operating system has built-in START RDR and START WTR 
commands, which are issued automatically. These commands are: 

START RDR, OOC 
START WTR, OOE 

If these are not the addresses of the reader and writer to be 
used, override these commands by entering new ones for the proper 
devices. 

(Continued) 
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T 1 

6. I Enter a START command with no parameters. When the job is 
I complete, a READER CLOSED message will be printed, followed by a 
I READY message. Then the system will enter the wait state. 

X 



Initialize Backup Disk 



7. 



H 



Place the IBCDASDI program (punched from SYSl.SAMPLIB in Step 
in the input device , followed by the control deck shown below. 



2) 



JOB 
MSG 
DADEF 

VLD 
VTOCD 

END 



TODEV= 1403 , TOADDR= OOE 

TODEV=2311 , TOADDR=190 , VOLID=SCRATCH, 

FLAGTEST=NO 

NEWV0LID= 111111 , OWNERID= DEPT38 

STRTADR=50 , EXTENT=10 



In the DADEF statement, the FLAGTEST=NO parameter must be used 
when the disk is initialized for the first time only. 



-+ 



Mount the disk pack that is to receive the 
first starter disk pack (DLIBOl) . 



backup copy of the 



IBCDASDI program by setting the load selector switches 

and pressing the console LOAD key. When the program is loaded, 

ate is entered and the hexadecimal value FFFF is 



Load f?the 

ing the conso 

he wait state is entered 

displayed in the console lights 



10. 



Define the control statement input device by pressing the REQUEST 
key of the printer keyboard. The message DEFINE INPUT DEVICE 
will be printed. Enter the message INPUT=xxxx cuu where xxx is 
the device type, c is the channel address, and uu is the unit 
address. The device type can be 14^2,2400, or 2540. 



11. 



When the disk initialization is complete, the message END OF JOB 
is printed on the message output device, and the program enters 
the wait state. 



Restore Backup Disk 



12. j Place the IBCDMPRS program (punched from SYSl.SAMPLIB in Step 2) 
I in the input device , followed by the control deck shown below. 



JOB 
MSG 
DUMP 

END 



TODEV=1403 , TOADDR= 00E 

FROMDEV=2311 , FROMADDR=190 , TODEV=2311, 

T0ADDR= 191 , V0LID=111111 



X 



I 

I When restoring is complete, the serial number 
I been changed from 111111 to DLIBOl. 



of the disk has 



13. j Load the IBCDMPRS program by setting the load selector switches 



I and pressing the console LOAD key. 
I the wait state is entered and 
I displayed in the console lights. 

.X . 



When the program is loaded, 
the hexadecimal value FFFF is 
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14. I Define the control statement input device by pressing the REQUEST 
I key of the printer keyboard. The message DEFINE INPUT DEVICE 
I will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
I the device type, c is the channel address, and uu is the unit 
{address. The device type can be 1442,2400, or 2540. 



15. jwhen the dumping is completed, the message END OF JOB is printed 
I on the message output device, and the program enters the wait 
1 state. 

X 



Initialize and Restore Second Backup Disk 



16. I Repeat steps 7 through 15 to create a backup copy of the second 
I disk pack (DLIB02) . 

X 



Initialize and Restore Third Backup Disk 



17. j Repeat steps 7 through 15 to create a backup copy of the third 
I disk pack (DLIB03) . Users of the customized starter package 
I should skip this step. 

± - 



List System Data 



18. 



To list the data describing the system, load the operating 
system, and place the proper control deck shown below in the 
input device. Then enter a START comjnand with no parameters. 

Control deck for users of the complete 2311 package: 

JOB ACCT123 , PROGRAMIVJER , MSGLEVEL=1 
PGM=IEHLIST 
SYSOUT=A 

UNIT=2311,DISP=OLD, X 

VOLUME=SER=DLIB01 

UNIT= (191 , , DEFER) , DISP= (NEW, KEEP) , X 

VOLUME= ( PRIVATE , RETAIN) 

UNIT=( 192,, DEFER), DISP=( NEW, KEEP) , X 

VOLUME= (PRIVATE , RETAIN) 
* 

LISTCTLG 

LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2311=DLIB02 

LISTVTOC DUMP,VOL=2311=DLIB0 3 

LISTPDS DSNAME= ( SYSl . PROCLIB , SYSl . COBLIB 

[, Optional PDSs on System Residence]) 
LISTPDS VOL=2311=DLIB02, X 

DSNAME = (SYSl . GENLIB , SYSl . SAMPLIB 

[, Optional PDSs on DLIB02]) 
LISTPDS VOL=2311=DLIB03, X 

DSNAME=SYS1.M0DLIB 
/* 



//J0B2 




JO 


//STEPl 


EXEC 


//SYSPRINT 


DD 


//DDl 




DD 


// 






//DD2 




DD 


// 






//DD3 




DD 


// 






//SYSIN 




DD 
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//JOB 2 




JO 


//STEPl 


EXEC 


//SYS PRINT 


DD 


//DDl 




DD 


// 






//DD2 




DD 


// 






//SYSIN 




DD 



Control deck for users of the customized 2311 package: 

JOB ACCT123 , PROGRAMMER , ]yiSGLEVEL=l 
PGM=IEHLIST 
SYSOUT=A 

UNIT=2311,DISP=OLD, X 

VOLUME=SER=DLIB01 

UNIT=( 191,, DEFER) ,DISP= (NEW, KEEP) , X 

VOLUME= (PRIVATE , RETAIN) 
* 

LISTCTLG 

LISTVTOC DUMP 

LISTVTOC DUMP,VOL=2311=DLIB02 

LISTPDS DSNAME= ( SYSl . PROCLIB , S YSlMODLIB 

t, Optional PDSs on System Residence]) 
LISTPDS VOL=2311=DLIB02, X 

DSNAME=SYS1 . GENLIB , SYSl . SAMPLIB 

[, Optional PDSs on DLIB02]) 
/* 

The physical address underlined in the DD2 statement should be 
the address of the device containing DLIB02. The physical 
address underlined in the DD3 statement should be the address of 
the device containing DLIB03. 

In the LIST deck, any of the partitioned data sets shown in 
Figure 47 may be specified in the LISTPDS statement. 
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2314 Package — Tape Distribution 

The procedure for processing the tape distribution of the 2314 
starter operating system package is as follows: 



Initialize Disk 



Mount disk pack onto which DLIBOl is to be restored. 



2. 

3. 



Mount the tape distribution (DLIBOl) of the starter package. 



Load the IBCDASDI program from the tape by setting the load 
selector switches and pressing the console LOAD key. When the 
program is loaded, the wait state is entered and the hexadecimal 
value FFFF is displayed in the console lights. 



Place the following control deck in the input device to initial- 
ize the disk. 



JOB 
MSG 
DADEF 

VLD 

VTOCD 

END 



TODEV=1U03 , TOADDR= OOE 

TODEV= 2314, TOADDR=130 , VOLID= SCRATCH , 

FLAGTEST=NO 

NEWV0LID= 111111 , 0WNERID= D£PT3 8 

STRTADR=50 , EXTENT=10 



In the DADEF statem.ent, the FLAGTEST=NO parameter must be used 
when the disk is initialized for the first time only. 



5. 



Define the control statement input device by pressing the REQUEST 
key of the printer keyboard. The message DEFINE INPUT DEVICE 
will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
the device type, c is the channel address, and uu is the unit 
address. The device type can be 1442, 2400, or 2540. 



6. 



When the disk initialization is complete, the message END OF JOB 
is printed on the message output device, and the program enters 
the wait state. 



Restore Tape to Disk 



Load the IBCDMPRS program from tape by setting the load selector 
switches and pressing the console LOAD key. When the program is 
loaded, the wait state is entered and the hexadecimal value FFFF 
is displayed in the console lights. 



Place the following control deck in the input device to restore 
the contents of the tape to the disk. 



JOB 
MSG 
RESTORE 

END 



TODEV= 1403 , TOADDR= OOE 

FROMDEV=24 00,FROMADDR=180,TODEV=2314, 

TOADDR=130 , V0LID= 111111 



When restoring is complete, the serial number of the disk has 
been changed from 11111 to DLIBOl. 



(Continued) 
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9. j Define the control statement input device by pressing the REQUEST 
I key of the printer keyboard. The message DEFINE INPUT DEVICE 
I will be printed. Enter the message INPUT=xxxx cuu where xxxx is 
I the device type, c is the channel address, and uu is the unit 
I address. The device type can be 1UU2, 2U00, or 25U0. 
+ ^ 

10. I When the restoring is complete, the message END OF JOB is printed 
I on the message output device, and the program enters the wait 
I state. 



JThe DLIBOl tape should be removed and stored in the tape 
I for backup purposes. 

.X 



library 



Punch Utility and Sample Programs 



11 



Completion of the preceding steps provides an operable disk pack 
with a backup tape. Proceed to punch the independent utility 
programs and any sample programs desired. Be sure the necessary 
volumes are mounted and make ready all devices to be used. 

_ : ^ 
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The following control deck should be placed in the input device. 



//JOBl 

// 

//SYSUTl 

// 

// 

//SYSUT2 

//SYSPRINT 

//SYSIN 



JOB ACCT123 , PROGRAMMER , MSGLEVEL=1 
EXEC PGM=IEBPTPCH 

DSNAME=SYS1 . SAMPLIB , 

DISP=( OLD, KEEP) ,UNIT=231U, 

VOLUME=SER=DLIB01 

UNIT=25U0-2 

SYSOUT=A 

* 

PUNCH TYPORG=PO , MAXNAME=4 
MEMBER NAME=IBCDMPRS 
MEMBER NAME=IBCDASDI 
MEMBER NAME=IEAIPLOO 
MEMBER NAME]=IBCRCVRP 



DD 



DD 
DD 
DD 



/* 



A MEMBER card should be added to the above control deck for the 
sample program desired for later use, and for SAMACTRT and 
PROCDUMP, provided the MAXNAME field in the PUNCH control card is 
adjusted to show the revised number of member cards in the deck. 
The member name card (first card) should be removed from each 
member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 



13. 



-+- 



Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system residence volume (DLIBOl) . 
Then press the LOAD key. 



in. 



Wait for the READY message and for the WAIT light to be turned 
on. Then enter a SET command specifying the date, as follows: 

a. Press REQUEST key. 

b. Wait for READ light to go on. 

c. Type SET DATE=yy.ddd to specify date. 

d. Hold alternate coding key and press the numeric 5 key (EOB) . 



(Continued) 
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15, 



The starter operating system has built-in START RDR and START WTR 
commands, which are issued automatically. These commands are: 

START RDR,OOC 
START WTR,OOE 

If these are not the addresses of the reader and the writer to be 
used, override these commands by entering new ones for the proper 
devices . 



16. 



Enter a START command with no parameters. When the job is 
complete, a READER CLOSED message will be printed, followed by a 
READY message. Then the system will enter the wait state. 



List System Data 



17, 



To list the data describing the system, place the control deck 
shown below in the input device. Then enter a START RDR command 
followed by a START command. 



//JOB 2 
//STEPl 
//SYSPRINT DD 



//DDl 
// 

//SYSIN 



DD 



DD 



JOB ACCT123 , PROGRAMMER , MSGLEVEL=1 
EXEC PGM=IEHLIST 

SYSOUT=A 

UNIT=23'14 ,DISP=OLD, 

VOLUME=SER=DLIB01 

* 
LISTCTLG 
LISTVTOC DUMP 
LISTPDS DSNAME=(SYSl.PROCLIB, 

SYSl .MODLIB , SYSl . GENLIB , 

SYSl.SAMPLIB 

(t, Optional PDSs on System Residence]) 



/* 



If J0B2 IS RUN IMMEDIATELY AFTER JOBl (in step 12) , eliminate the 
JOB 2 card. 

In the LIST deck, any of the partitioned data sets shown in 
Figure 47 may be specified in the LISTPDS statement. 
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Deleting Libraries 

To make additional direct-access storage available for the system 
generation process, you may elect to delete the SYSl.SAMPLIB library 
from your operable pack before starting the system generation process. 
This may be accomplished by loading the operating system and using the 
control deck shown in the input device. 

//JOB2 JOB ACCT123 , PROGRAMMER , MS GLEVEL=1 

//STEP2 EXEC PGM=IEHPROGM 

//SYSPRINT DD SYSOUT=A 

//DDl DD UNIT= (191,, DEFER) ,DISP= (NEW, KEEP) , X 

VOLUME= ( PRIVATE , RETAIN) 
//SYS IN DD * 

SCRATCH DSNAME=SYS1.SAMPLIB. X 

VOL=2311=DLIB02, PURGE' 
/* 
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Cross-references in macro-instructions 
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CTRLPROG macro-instruction 
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PL/I 98 
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FORTLIB macro- instruction 96-97 
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sample program 136 
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SYSl.FORTLIB 10,14,18,20,106,113,175 
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SYSl.GENLIB 10,13,109,174,175 

obtaining 14,150 
SYSl . LINKLIB 8 , 13 , 18 , 20 , 62 , 73 , 105 , 106 , 113 
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space allocation 22,23-27 
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Date September 19, 1967 
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This technical newsletter corresponds to Release 13 and con- 
tains amendments to the System Generation publication. Replace- 
ment and/or supplemental pages to be inserted in the publication 
are noted below. Corrections and additions to text and/or illus- 
trations are indicated by a vertical bar to the left of the text 
or illustrations and a bullet (•) to the left of an illustration 
caption. 
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Pages to Be 
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73-74 
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Summary of Amendments 

This technical newsletter describes the generation 
Graphics Subroutine Package (GSP) for FORTRAN IV. 
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Note: Please file this cover letter at the back of the publica- 
tion. Cover letters provide a quick reference to amendments and a 
means of checking receipt of all amendments . 
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This technical newsletter corresponds to Release 14 and con- 
tains amendments to the System Generation publication. Replace- 
ment and/or supplemental pages to be inserted in the publication 
are noted below. Corrections and additions to text and/or 
illustrations are indicated by a vertical bar to the left of the 
text or illustration and a bullet (•) to the left of the 
illustration caption. 
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Summary of Amendments 



This technical newsletter modifies the lOCONTRL, lODEVICE, 
UNITNAME, SCHEDULR, SUPRVSOR, FORTRAN, and GENERATE macro instruc- 
tions. The graphics sample program and the list of generic unit 
names have been updated. The use of the lEBEDIT utility program 
to restart Stage II is also described. Figures 26 and 36 have 
been reprinted to facilitate references to them. 

Note: Please file this cover letter at the back of the publica- 
tion. Cover letters provide a quick reference to changes, and a 
means of checking receipt of all amendments. 
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